Search creators

Find creators. Search semantically with query, or look them up by name, id, or social handle. Either way, you can also narrow the results with filters such as audience profile, location, and follower count.

Send one search field. Each field is its own mode:

• Query (query). A natural-language brief. Runs a language model and ranks by relevance, so sortBy is ignored. Bills at least one row even when nothing matches.
• Name (names). Fuzzy-matches account names (a case-insensitive contains match). Pass every name in one array.
• ID (ids). Looks up known ids. Missing ids are omitted and listed in unmatchedIds. limit and offset are ignored.
• Instagram (igUsername). Case-insensitive contains match on the handle. A leading @ is ignored.
• TikTok (tiktokUsername). Same match on the TikTok handle.

If a request includes more than one of these fields, only the highest priority field is used. The rest are ignored:

1. ids
2. igUsername or tiktokUsername (if both are set, either handle can match)
3. names
4. query

One exception: query together with names uses both. names narrows the set, and query ranks inside it.

limit (default 20, max 100) caps the rows returned, and the cost, for every mode except ID.

Limited to 120 requests per minute per user. Costs $0.0010 per creator returned, charged against your plan’s monthly credits. The count field is what you were charged for. A query search runs a language model, so it bills a minimum of one row even when nothing matches.