Skip to content

Discovery API

Operations

Discovery API

Request

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.
Security
Bearer
Query
return_filter_valuesboolean

Include a matched_filters object on each returned creator.

Body
platformstringrequired
Value:"instagram"
Discriminator
pagingobject(PagingRequest)required
sortobject(SortRequest)
filtersobject(InstagramDiscoveryFilters)required
POST
/public/v1/discovery/
curl -i -X POST \
  'https://api-dashboard.influencers.club/public/v1/discovery/?return_filter_values=true' \
  -H 'Authorization: Bearer <YOUR_API_KEY_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "platform": "instagram",
    "nlp_search": "fitness creators in New York with over 100k followers",
    "filters": {
      "location": [
        "United States"
      ],
      "number_of_followers": {
        "min": 1000
      },
      "profile_language": [
        "en"
      ],
      "engagement_percent": {
        "min": 0.5
      }
    },
    "sort": {
      "sort_by": "relevancy",
      "sort_order": "desc"
    },
    "paging": {
      "limit": 10,
      "page": 0
    }
  }'

Responses

Bodyapplication/json
totalintegerrequired
limitintegerrequired
credits_leftstring, (decimal)^-?\d{0,8}(?:\.\d{0,2})?$required
accountsArray of objects(AccountResponse)
applied_filtersobject

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

Response
{
  "total": 0,
  "limit": 0,
  "credits_left": "string",
  "accounts": [
    { … }
  ],
  "applied_filters": {
    "property1": null,
    "property2": null
  },
  "nlp_search": {
    "from_nlp": { … },
    "overridden_by_user": [ … ],
    "notes": [ … ]
  }
}