---
title: "Find creators by description and filters"
method: POST
path: "/searches"
tags: ["creators"]
---

# Find creators by description and filters

`POST /searches`

## Request

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

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.

## Request body

- object
  - `query` string, required: The creators you want, in plain words
  - `platforms` string[]: Only creators on these platforms
  - `markets` string[]: Only creators in these countries, e.g. us, gb, jp
  - `audienceCountries` string[]: Only creators whose largest audience is in these countries, e.g. us, gb, th
  - `languages` string[]: Only creators posting in these languages, e.g. english
  - `lastPostWithinDays` integer: Only creators whose latest post is at most this many days old: 7, 14, 30, 90 or 180
  - `minFollowers` integer: At least this many followers
  - `maxFollowers` integer: At most this many followers
  - `minAvgViews` integer: At least this many average views per post
  - `maxAvgViews` integer: At most this many average views per post
  - `minEngagementRate` number: At least this engagement rate, as a fraction: 0.02 for 2%
  - `maxEngagementRate` number: At most this engagement rate, as a fraction: 0.1 for 10%
  - `campaignId` string: Rank for this campaign and record the search in it
  - `limit` integer: How many to return, 1-100 (default 20)

## Response `200`

Success

- object
  - `data` unknown, required

## Other responses

- `4XX`: Failure; `error.code` says what to do
- `5XX`: Failure; `error.code` says what to do

---

[API](https://skmtc.dev/creatorriver/apis/creator-river-api.md) · [All operations](https://skmtc.dev/creatorriver/apis/creator-river-api/llms.txt) · [OpenAPI document](https://skmtc.dev/creatorriver/apis/creator-river-api/revisions/d3707b18785c?raw)