Creator Advanced Search Filters - CreatorDB Documentation Center

Overview

CreatorDB supports searching YouTube, Instagram, TikTok, Threads, and Facebook with predefined filters. When making the API call, you can specify which predefined filters you’d like to add to your search using the POST method. Supported filters vary based on the social media platform.

API call flow

1

Get creator's ID.

Use the advanced search API to find and get creator IDs based on specified filter conditions. You can filter creators by country, platform metrics, YouTube audience demographics, etc. Note only YouTube audience demographics is currently available.

2

Get creator's detailed data and performance metrics.

Use the creator ID obtained from calling the advanced search API to make data API requests to get the creator’s detailed information and performance metrics. You can get the creator’s basic profile information, account’s historical performance data, contact information, and more.

API call flow

Request body parameters

Name	Required	Type	Example	Description
`offset`	True	`number`	0	Specifies the number of records to skip before returning results. For example, if the offset is 5,001 and there are 10,000 search results, the returned data will skip the first 5,000 results.
`maxResults`	True	`number`	100	The maximum number of records to return. The maximum number of search results returned per call is 2,500. After the 2,500 result, you must specify the offset value to get the remaining results.
`sortBy`	False	`string`	subscribers	The field to sort results by. For example, if the value is `subscribers`, the creators that meet the search criteria are organized by the number of subscribers they have.
`desc`	True	`boolean`	true	Specifies whether the data returned should be sorted in descending order. When the value is `true`, it will return data in descending order. Otherwise, when `false` the returned data will be in ascending order.
`filters`	True	`object[]`		An array of filter objects that includes: `filterKey`,`op`, and `value`.
└─ `filterKey`	True	`string`	subscribers	The field to apply the filter on.
└─ `op`	True	`string`	=	The comparison operator. Available values include `in`, `>`, `=`, `<`. Note that all string type filter values support the operation `in`.
└─ `value`	True	`string`/`number`/`boolean`/`string`	10000	The data type depends on the `filterKey`: -subscribers (`number`) -mainLanguage (`string`) -hasEmail (`boolean`) For more details, see: Configuring Advanced Search Filters and Examples

Last modified on May 18, 2026

⌘I