v1

latestOpenAPI 3.0.32026-08-0670174396.8 KB
Discovery 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

OR
OR
OR
OR
OR

Example request

{
  "filters": {
    "creator_has": {}
  }
}

Response

totalinteger required
limitinteger required
credits_leftstring decimal required