latestOpenAPI 3.0.32026-08-1873190485.1 KB
87e654ac822e
Discovery API
Discovery API
Search and discover creators across multiple platforms using advanced filtering and search.
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.
Platform-specific filters
- The available filters depend on the platform you choose — switching platform changes the filter fields in the request body.
- Use the Dictionary endpoints to retrieve valid values for filters such as locations, languages, brands, audience interests, and audience locations.
Natural-language search
- Optional — filters work on their own. Sending an nlp_search brief lets you describe who you're looking for in plain language instead of building filters by hand, and you can combine the two.
- The 200 response adds applied_filters (what the search actually ran with) and nlp_search (what the AI inferred, and why anything was dropped).
Credits
- 0.01 credits per creator returned — 0 creators, 0 credits.
- Every request that returns creators is billed, even with identical filters. Monitoring your request volume and credit usage is your responsibility.
- Usage is capped per billing period — see Usage & limits for how the cap works and what happens when you reach it.
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 its schema in the 200 response for the shape of each field. 0.03 credits per creator instead of 0.01, and the unique-handle cap is unchanged. See the FAQ for an example.
post/public/v1/discovery/
Query parameters
return_filter_valuesboolean
Include a matched_filters object on each returned creator.