Skip to main content

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.

By default, creators will assign a category to their YouTube channel out of pre-defined categories to help viewers find their content. These YouTube-defined categories can be used as search criteria or filters in the CreatorDB database to help you narrow the search scope and find relevant creators quickly. The following list contains all the accepted mainCategory values in alphabetical order:
  • Autos & Vehicles
  • Comedy
  • Education
  • Entertainment
  • Film & Animation
  • Gaming
  • Howto & Style
  • Music
  • News & Politics
  • Nonprofits & Activism
  • Pets & Animals
  • People & Blogs
  • Science & Technology
  • Sports
  • Travel & Events

​
Code sample

Using the POST method to call the youtubeAdvancedSearch API, you can filter YouTube creator search results by their channel category. Calling the CreatorDB API with the code below will search the database for YouTube creators in the gaming category who are from the U.S. and have 10,000 to 100,000 subscribers. This call will return 10 creators that meet the search criteria and sort them by the number of subscribers they have in descending order. For details, see Configuring Advanced Search Filters and Examples. 
curl --request POST \
  --url https://dev.creatordb.app/v2/youtubeAdvancedSearch \ 
  --header 'Accept: application/json' \  
  --header 'Content-Type: application/json' \ 
  --header 'apiId: YOUR\_API\_KEY' \ 
  --data '{  
  "maxResults": 10,  
  "sortBy": "subscribers",  
  "offset": 0,  
  "desc": true,  
  "filters": [  
    {  
      "filterKey": "mainCategory",  
      "op": "=",  
      "value": "Gaming"  
    },  
    {  
      "filterKey": "country",  
      "op": "=",  
      "value": "USA"  
    },  
    {  
      "filterKey": "subscribers",  
      "op": ">",  
      "value": 10000  
    }  
    ,  
     {  
      "filterKey": "subscribers",  
      "op": "<",  
      "value": 100000  
    }  
  ]  
}'
Last modified on February 9, 2026