v1
latestOpenAPI 3.0.32026-08-0670174396.8 KBDiscovery API
Discovery API
Search and discover creators across multiple platforms using advanced filtering and search.
Platform-specific filters
- The available filters depend on the platform you choose.
- When you switch platform, you’ll see different filter fields available in the request body for that platform.
- Use the Dictionary endpoints to retrieve valid values for filters such as locations, languages, brands, audience interests, and audience locations.
Credits
- 0.01 credits per creator returned. If a request returns 0 creators, 0 credits are deducted.
- Credits are consumed on every request that returns creators, even if the filters are identical to a previous request.It is the client's responsibility to monitor request volume and credit usage.
- Discovery usage is capped per billing period. See Usage & limits for how the cap works and what happens when you reach it.
What you get
- Paginated list of creator profiles with profile info, follower counts, engagement rates, and analytics. Instagram creators (10k+ followers) also include audience demographics and interest data.
- Supports Instagram, YouTube, TikTok, Twitch, Twitter, and OnlyFans platforms.
Premium: matched filter values return_filter_values=true — each returned creator includes a matched_filters object showing exactly which of your filter values it matched. See the matched_filters schema in the 200 response for the shape of each field. Billed at 0.03 credits per creator instead of 0.01 (replaces the base rate, not additive); the unique-handle cap is unchanged. See Can I see which filter values each creator matched? for a request and response example.
<div class="ic-ai-prompt-root" data-endpoint="discovery"></div>post/public/v1/discovery/
Query parameters
return_filter_valuesboolean
Request body
Example request
{
"filters": {
"creator_has": {}
}
}