Search Creators Across Platforms
Search for creators across YouTube, Instagram, and TikTok in a single request, instead of running a separate search on each platform. Each result is one creator, with their accounts on each platform grouped together.
You can search in three ways:
- By attributes. Filter on aggregate and main-platform attributes.
- By a known account. If you already know one of a creator’s accounts, find their accounts on other platforms using a handle filter (
youtubeId,instagramId,tiktokId) or a permanent ID filter (youtubeChannelId,instagramNumericId,tiktokNumericId). Permanent IDs don’t change when a creator renames their handle. - By email address. Find the creators associated with a list of email addresses using the
emailfilter.
Each request requires at least 1 filter and accepts up to 10 filters.
By default, the creators list is sorted by creatorDBScore in descending order. To change the order, use the sortBy parameter.
Credit costs:
- Standard requests cost 1 credit per page.
- Requests that include the
keywordsfilter cost 3 credits per page. - Requests that include the
emailfilter are charged per matched email address instead of per page. Each input address that matches at least one creator on the returned page costs 15 credits, even if it matches several creators. Addresses with no match cost nothing.
For all prices, see API Credit Usage.
Body
Search for creators across YouTube, Instagram, and TikTok by attributes, by a known account, or by email address.
Filter objects that include filterName, op, and value. For the keywords and searchName filters, you can also set the optional isFuzzySearch. For all accepted filterName values and their data types, see Configuring Custom Search Filters and Examples.
1 - 10 elementsResponse
Creator search results returned successfully.
Creator Search API response with creator list and pagination.