> ## Documentation Index
> Fetch the complete documentation index at: https://docs.creatordb.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Creator Advanced Search Filters

> Search for specific creators using advanced filters

## 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

<Steps>
  <Step title="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.
  </Step>

  <Step title="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.
  </Step>
</Steps>

<img src="https://mintcdn.com/creatordb-589c46f5/ZFQVqHig0HGLy5zw/assets/images/api_call_flow.png?fit=max&auto=format&n=ZFQVqHig0HGLy5zw&q=85&s=cfa22025acfb7708c65142e0c11f4643" alt="API call flow" width="32768" height="8816" data-path="assets/images/api_call_flow.png" />

## 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`:<br />-subscribers (`number`)<br />-mainLanguage (`string`)<br />-hasEmail (`boolean`)<br />For more details, see: [Configuring Advanced Search Filters and Examples](https://docs.creatordb.app/api-v2/configuring_advanced_search_filters) |