# 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.

Limits
- Up to 10,000 relevant results can be fetched by each query. Fetching data after the 10,000th result is not allowed.
- Each account has a separate Discovery API credit limit equal to 10% of the plan's total credits, which resets each billing cycle. See the FAQ for details.

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.

Endpoint: POST /public/v1/discovery/
Version: 1.0.0
Security: Bearer

## Response 200 fields (application/json):

  - `total` (integer, required)

  - `limit` (integer, required)

  - `credits_left` (string, required)

  - `accounts` (array)

  - `accounts.user_id` (string, required)
    The creator's unique platform identifier.

  - `accounts.profile` (object, required)

  - `accounts.profile.full_name` (string, required)

  - `accounts.profile.username` (string, required)
    The creator's username on the platform.

  - `accounts.profile.picture` (string, required)

  - `accounts.profile.followers` (integer, required)

  - `accounts.profile.engagement_percent` (number, required)


## Response 400 fields

## Response 401 fields

## Response 422 fields