Skip to main content
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 in creator/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

  • When a creatorId is no longer available, the request doesn’t return an error. It’s charged like any search: 1 credit, or 3 credits with keywords.
  • Treat creatorId as an opaque string. The ID’s prefixes, such as yt, ig, and tt, show the platform the record was created from, not the current main platform. For example, a creatorId such as yt_UC4-79UOlP48-QNGgCko5p2g may have Instagram as the main platform.
The uniqueId returned for YouTube includes the prefix @. For example, @mrbeast. Instagram and TikTok handles returned strip @, for example mrbeast.
The data object also includes three pagination fields:
  • totalResults: The total number of creators that match your request
  • offset: The offset value used in this request
  • pageSize: The pageSize value used in this request
To get the next page, increase 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.
This endpoint doesn’t support 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.
Last modified on November 16, 2026