POST https://apiv3.creatordb.app/creator/search
Unlike {platform}/search endpoints that return accounts, creator/search returns people. Each row is one creator, with their linked YouTube, Instagram, and TikTok accounts attached, so a multi-platform creator appears once instead of once per platform.
Use creator/search for two scenarios:
- Discovery: Find creators by attributes such as country, language, follower count, keywords, or sponsorship history.
- Resolution: Match accounts you already have to their creator, including uncovering the creator’s unknown accounts on other platforms.
To search creator accounts within a single platform, use
youtube/search, instagram/search, or tiktok/search. Those return richer per-platform metrics. creator/search trades that depth for the cross-platform view.Request
This example resolves a YouTube channel ID to its creator.Filters
The filters that you can use increator/search fall into three categories: Discovery, Resolution, and Fuzzy matching. Each category has its own set of filters and usage guidelines. For the filters in each category, see Configuring Custom Search Filters and Examples.
Response
The
uniqueId returned for YouTube includes the prefix @. For example, @mrbeast. Instagram and TikTok handles returned strip @, for example mrbeast.data object also includes three pagination fields:
totalResults: The total number of creators that match your requestoffset: Theoffsetvalue used in this requestpageSize: ThepageSizevalue used in this request
offset by pageSize and send the request again. Stop when offset is greater than or equal to totalResults. If offset combined with pageSize is less than totalResults, there is another page of results. Do not treat a page with fewer rows than pageSize as the last page, keep paging until you reach the totalResults.
Results are sorted by the sortBy field you requested, or by the creatorDBScore descending if unspecified. It is not sorted by input order. Since one input can match several creators, matches can land on any page. To find unmatched inputs, keep paging with offset and pageSize.
totalResults is the number of creators matching your filters. It’s recounted on every request, so it can change slightly between pages.
To get metrics, audience data, or contact details for an account, take its ID from platforms and call the matching platform endpoint, such as youtube/performance or instagram/contact.
Cost
Each request is charged once, and the price depends on the filters you use:
How email lookups are charged:
- Each page is charged separately. If an address’s creator shows up on another page, the address is charged again there.
- On one page, each address counts once, even if you entered it twice or it matches several creators.
- An address with no match costs nothing, so a lookup with no matches costs 0 credits.
fields yet. If you send it, it’s ignored.
For details, see API credit usage.
Limits
Notes
- Linked accounts come from links on the creators’ own profiles and CreatorDB’s account mapping, not from name similarity.