creators

Find creators by description and filters

Searches the creator database by meaning: describe the creators you want in plain words (niche, content, audience), and optionally narrow by platform, creator country, audience country, language, size, engagement rate and how recently they posted. Free, but each call counts against the daily search limit (see get_account). Results of creators you have not unlocked show a masked name. Pass campaignId to rank against that campaign’s brief and record the search in it.

post/searches

Request

  • Base URL: https://www.creatorriver.com/api/v1
  • URL: https://www.creatorriver.com/api/v1/searches
  • Auth: HTTP bearer

Request body

querystring required

The creators you want, in plain words

platformsstring[]

Only creators on these platforms

marketsstring[]

Only creators in these countries, e.g. us, gb, jp

audienceCountriesstring[]

Only creators whose largest audience is in these countries, e.g. us, gb, th

languagesstring[]

Only creators posting in these languages, e.g. english

lastPostWithinDaysinteger

Only creators whose latest post is at most this many days old: 7, 14, 30, 90 or 180

minFollowersinteger

At least this many followers

maxFollowersinteger

At most this many followers

minAvgViewsinteger

At least this many average views per post

maxAvgViewsinteger

At most this many average views per post

minEngagementRatenumber

At least this engagement rate, as a fraction: 0.02 for 2%

maxEngagementRatenumber

At most this engagement rate, as a fraction: 0.1 for 10%

campaignIdstring

Rank for this campaign and record the search in it

limitinteger

How many to return, 1-100 (default 20)

Response

Success

dataunknown required

Changes

No recorded changes to this operation across all 1 revision of this API.