POST /public/v1/discovery/ – Influencers Core API Concepts

Discovery API

Changed on Oct 7, 2026

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, audience locations, niche, and sub_niche.

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/

Request

Base URL
https://api-dashboard.influencers.club
Auth
HTTP bearer
TypeScript
https://skmtc.dev/influencers/apis/core-api-concepts/docs/public/v1/discovery/post.ts
A function with typed inputs. Its response is checked against the schema.

Query parameters

return_filter_valuesboolean

Include a matched_filters object on each returned creator.

Request body

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.

Changes

Oct 7, 202607fd7d5f3314 Revision changes
- info
  added the new optional request property ///// (media type: application/json)
- info
  added the new optional request property ///// (media type: application/x-www-form-urlencoded)
- info
  added the new optional request property ///// (media type: multipart/form-data)
- info
  added the new optional request property ///// (media type: application/json)
- info
  added the new optional request property ///// (media type: application/x-www-form-urlencoded)
- info
  added the new optional request property ///// (media type: multipart/form-data)
- info
  added the new optional request property ///// (media type: application/json)
- info
  added the new optional request property ///// (media type: application/x-www-form-urlencoded)
- info
  added the new optional request property ///// (media type: multipart/form-data)
- info
  added the new optional request property ///// (media type: application/json)
- info
  added the new optional request property ///// (media type: application/x-www-form-urlencoded)
- info
  added the new optional request property ///// (media type: multipart/form-data)
- info
  added the new optional request property ///// (media type: application/json)
- info
  added the new optional request property ///// (media type: application/x-www-form-urlencoded)
- info
  added the new optional request property ///// (media type: multipart/form-data)
- info
  added the new optional request property ///// (media type: application/json)
- info
  added the new optional request property ///// (media type: application/x-www-form-urlencoded)
- info
  added the new optional request property ///// (media type: multipart/form-data)
- info
  added the new optional request property ///// (media type: application/json)
- info
  added the new optional request property ///// (media type: application/x-www-form-urlencoded)
- info
  added the new optional request property ///// (media type: multipart/form-data)
- info
  added the new optional request property ///// (media type: application/json)
- info
  added the new optional request property ///// (media type: application/x-www-form-urlencoded)
- info
  added the new optional request property ///// (media type: multipart/form-data)
- info
  added the new optional request property ///// (media type: application/json)
- info
  added the new optional request property ///// (media type: application/x-www-form-urlencoded)
- info
  added the new optional request property ///// (media type: multipart/form-data)
Aug 18, 202687e654ac822e Revision changes
- breaking
  the / response's property type changed from object to array for status
- info
  added the new optional request property ////// (media type: application/json)
- info
  added the new optional request property ////// (media type: application/x-www-form-urlencoded)
- info
  added the new optional request property ////// (media type: multipart/form-data)
- info
  added the new optional request property //// (media type: application/json)
- info
  added the new optional request property //// (media type: application/x-www-form-urlencoded)
- info
  added the new optional request property //// (media type: multipart/form-data)
- info
  added the new optional request property ////// (media type: application/json)
- info
  added the new optional request property ////// (media type: application/x-www-form-urlencoded)
- info
  added the new optional request property ////// (media type: multipart/form-data)
- info
  added the new optional request property //// (media type: application/json)
- info
  added the new optional request property //// (media type: application/x-www-form-urlencoded)
- info
  added the new optional request property //// (media type: multipart/form-data)
- info
  added the new optional request property ////// (media type: application/json)
- info
  added the new optional request property ////// (media type: application/x-www-form-urlencoded)
- info
  added the new optional request property ////// (media type: multipart/form-data)
- info
  added the new optional request property //// (media type: application/json)
- info
  added the new optional request property //// (media type: application/x-www-form-urlencoded)
- info
  added the new optional request property //// (media type: multipart/form-data)
- info
  added the new optional request property ////// (media type: application/json)
- info
  added the new optional request property ////// (media type: application/x-www-form-urlencoded)
- info
  added the new optional request property ////// (media type: multipart/form-data)
- info
  added the new optional request property //// (media type: application/json)
- info
  added the new optional request property //// (media type: application/x-www-form-urlencoded)
- info
  added the new optional request property //// (media type: multipart/form-data)
- info
  added the new optional request property ////// (media type: application/json)
- info
  added the new optional request property ////// (media type: application/x-www-form-urlencoded)
- info
  added the new optional request property ////// (media type: multipart/form-data)
- info
  added the new optional request property //// (media type: application/json)
- info
  added the new optional request property //// (media type: application/x-www-form-urlencoded)
- info
  added the new optional request property //// (media type: multipart/form-data)
- info
  added the new optional request property ////// (media type: application/json)
- info
  added the new optional request property ////// (media type: application/x-www-form-urlencoded)
- info
  added the new optional request property ////// (media type: multipart/form-data)
- info
  added the new optional request property //// (media type: application/json)
- info
  added the new optional request property //// (media type: application/x-www-form-urlencoded)
- info
  added the new optional request property //// (media type: multipart/form-data)
- info
  added the media type application/json for the response with the status
- info
  added the media type application/json for the response with the status
- info
  added the non-success response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property //// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the required property to the response with the status

Operation history (3 revisions)