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.
<div class="ic-ai-prompt-root" data-endpoint="discovery"></div>
post/public/v1/discovery/

Query parameters

return_filter_valuesboolean

Include a matched_filters object on each returned creator.

Request body

OR
OR
OR
OR
OR

Response

totalinteger required
limitinteger required
credits_leftstring decimal required
applied_filtersobject

The effective filter set the search ran with — your explicit filters layered over anything the AI inferred.