Skip to main content
POST
Search creators

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
platform
enum<string>
required
Available options:
all,
instagram,
tiktok,
youtube
kind
enum<string>
required
Available options:
structured,
ai_text,
lookalike,
result_image
idempotency_key
string<uuid>
required
sort
enum<string>
default:relevance
Available options:
relevance,
followers,
engagement
page
integer
default:0
Required range: 0 <= x <= 99
page_size
integer
default:15
Required range: 1 <= x <= 15
query
string
Maximum string length: 2000
filters
object
creator_refs
string[]
Required array length: 1 - 5 elements
Maximum string length: 20000
visual_ref
string
Maximum string length: 5000
max_credits
integer
Required range: x >= 0
exclude_saved
boolean
default:false
proposal_candidate_id
string
Required string length: 1 - 200

Response

Default Response

items
Creator · object[]
required
total
number
required

How many creators match, as estimated by the search

page
integer
required
Example:

0

page_size
integer
required
Example:

20

has_more
boolean
required
terminal
boolean
required

True when no further page can be read for this search

credits_cost
number
required

Credits this page cost; 0 for a free or cached page

content_pending
boolean

True when the creators' recent posts are not part of this response

free_pages_remaining
null | integer

Free result pages left today after this one; null when it could not be read

filtered_out_count
integer
excluded_count
integer

Creators left out because they are already on one of your creator lists (exclude_saved)