YouTube

Search Creators

Search for YouTube creators using advanced filters such as displayName, subscriber count, video performance, and more. Supports fuzzy search, pagination, and multiple filter combinations. At least one filter is required. By default the creatorList is sorted by displayName. Custom sorting can be applied using the sortBy parameter.

Optionally pass fields to enrich each search result with data from other endpoints. Enrichment is billed per result returned, using each endpoint’s own pricing rules. Fractional calls must be enabled on your API key. For details, see Fractional Calls.

POST

youtube

cURL

curl -X POST "https://apiv3.creatordb.app/youtube/search" \
  -H "Content-Type: application/json" \
  -H "api-key: <YOUR_API-KEY_HERE>" \
  -d '{
    "filters":[
    {
      "filterName":
        "totalSubscribers",
        "op":">",
        "value":1000000
    }
    ],
    "pageSize":10,
    "offset":0
    }'

const options = {
  method: 'POST',
  headers: {'api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    filters: [{filterName: 'totalSubscribers', op: '>', value: 1000000, isFuzzySearch: true}],
    desc: true,
    sortBy: 'displayName',
    pageSize: 10,
    offset: 0
  })
};

fetch('https://apiv3.creatordb.app/youtube/search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://apiv3.creatordb.app/youtube/search"

payload = {
    "filters": [
        {
            "filterName": "totalSubscribers",
            "op": ">",
            "value": 1000000,
            "isFuzzySearch": True
        }
    ],
    "desc": True,
    "sortBy": "displayName",
    "pageSize": 10,
    "offset": 0
}
headers = {
    "api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://apiv3.creatordb.app/youtube/search",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'filters' => [
        [
                'filterName' => 'totalSubscribers',
                'op' => '>',
                'value' => 1000000,
                'isFuzzySearch' => true
        ]
    ],
    'desc' => true,
    'sortBy' => 'displayName',
    'pageSize' => 10,
    'offset' => 0
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

require 'uri'
require 'net/http'

url = URI("https://apiv3.creatordb.app/youtube/search")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"filters\": [\n    {\n      \"filterName\": \"totalSubscribers\",\n      \"op\": \">\",\n      \"value\": 1000000,\n      \"isFuzzySearch\": true\n    }\n  ],\n  \"desc\": true,\n  \"sortBy\": \"displayName\",\n  \"pageSize\": 10,\n  \"offset\": 0\n}"

response = http.request(request)
puts response.read_body

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://apiv3.creatordb.app/youtube/search"

	payload := strings.NewReader("{\n  \"filters\": [\n    {\n      \"filterName\": \"totalSubscribers\",\n      \"op\": \">\",\n      \"value\": 1000000,\n      \"isFuzzySearch\": true\n    }\n  ],\n  \"desc\": true,\n  \"sortBy\": \"displayName\",\n  \"pageSize\": 10,\n  \"offset\": 0\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://apiv3.creatordb.app/youtube/search")
  .header("api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"filters\": [\n    {\n      \"filterName\": \"totalSubscribers\",\n      \"op\": \">\",\n      \"value\": 1000000,\n      \"isFuzzySearch\": true\n    }\n  ],\n  \"desc\": true,\n  \"sortBy\": \"displayName\",\n  \"pageSize\": 10,\n  \"offset\": 0\n}")
  .asString();

{
  "data": {
    "creatorList": [
      {
        "displayName": "🪐🌍Gallivud_prod",
        "uniqueId": "@gallivud_prod",
        "channelId": "UCMS8ONu5i0tKTyZ4_lLD1DA",
        "avatarUrl": "https://yt3.googleusercontent.com/geeG3ok-_7PzCBlXDEW8Ro2m0QNl_XRH4AekEVvPqBhgmrFJbn2iKzn06lSnI2GnkybvaJY7=s900-c-k-c0x00ffffff-no-rj",
        "totalSubscribers": 1400000
      },
      {
        "displayName": "🪐MILENA MARS🪐",
        "uniqueId": "@milenamars",
        "channelId": "UCjTWFYn4s7fzsonX3Jtw_Ig",
        "avatarUrl": "https://yt3.googleusercontent.com/kFfAtp8wQM5wTqRzFn1wiZWdcJ5atGU1u-BnzpadbVFQJBThObAYNZTxsagdHnzW5m79G5A4pg=s900-c-k-c0x00ffffff-no-rj",
        "totalSubscribers": 2170000
      },
      {
        "displayName": "🩷La Barbie Jimenez 🩷",
        "uniqueId": "@labarbiejimenez",
        "channelId": "UC2Z5u_Azat1RoqK-7-Sy4Tg",
        "avatarUrl": "https://yt3.googleusercontent.com/h6_4n7pOk4AAn93qpxZl0abQZjYtg4PtzxXnsPO3l4wF7p3d8271Q_F_TqeUDsvuQKA6aIPaxYo=s900-c-k-c0x00ffffff-no-rj",
        "totalSubscribers": 1050000
      },
      {
        "displayName": "🦋wishkhanna_🦋",
        "uniqueId": "@wishkhanna____",
        "channelId": "UC32P0rFNpMhz97Oast8Mdgg",
        "avatarUrl": "https://yt3.googleusercontent.com/rubd3-FNnl6pEpm5po_t6J67FE0IV_p452ujgAlxs1QITLGzi-nObStp06dbR3Qz96RJ5gm1=s900-c-k-c0x00ffffff-no-rj",
        "totalSubscribers": 1450000
      },
      {
        "displayName": "🥜𝐀𝐧𝐲𝐚 𝐂𝐡𝐚𝐧🥜",
        "uniqueId": "@yandere79",
        "channelId": "UCVYsu-OqwXh9wF9eHERXcNg",
        "avatarUrl": "https://yt3.googleusercontent.com/kOFqPM33m-b9YLSSjS499UciWpwZMJ0-MLmTjycnBUoGr3OCF2-yH8lMrT4VDgi4XznVX7TA9w=s900-c-k-c0x00ffffff-no-rj",
        "totalSubscribers": 2250000
      },
      {
        "displayName": "🤍cloudy express 🤍",
        "uniqueId": "@cloudyexpress-cb3pf",
        "channelId": "UCo7-sHv2yP_tk2FFbfwmILQ",
        "avatarUrl": "https://yt3.googleusercontent.com/c5pVxWtJhkU12B3D_MS_pfEV-9wpwyxsCHHrOLP67tEQgAf5uNwreDaPHxIqIqS81LIRbjX8w8A=s900-c-k-c0x00ffffff-no-rj",
        "totalSubscribers": 1030000
      },
      {
        "displayName": "🙏Jay shri shyam🙏",
        "uniqueId": "@bhaktisagar609",
        "channelId": "UC2e-a4J25uO7Vqdz5s9D39w",
        "avatarUrl": "https://yt3.googleusercontent.com/1onewDKzTDXArcN-SSOogr_-eGczRvnWi2jlcxMGaxSJq9e8DDMgFwfs7BpaXogQwfFt2Cm3=s900-c-k-c0x00ffffff-no-rj",
        "totalSubscribers": 1810000
      },
      {
        "displayName": "🙏 Pray Together 🙏",
        "uniqueId": "@frastefano",
        "channelId": "UCEISS2bKsVnyvPSGvK-q_mg",
        "avatarUrl": "https://yt3.googleusercontent.com/lqbSpiP1yWva-3v1pbFlZ--tVLaQJuCwGP1vvoAi75-w-VqJe0QDzUxqtfwUfE25Qem15nxy3w=s900-c-k-c0x00ffffff-no-rj",
        "totalSubscribers": 1270000
      },
      {
        "displayName": "🖤BRK",
        "uniqueId": "@mr.say3ed",
        "channelId": "UCCQ7XwHCZetFk0zJWadP1Ww",
        "avatarUrl": "https://yt3.googleusercontent.com/kr5zTRyltQF-7K7iCIiB9iMV1wOmvpRPYvUeIqa_KdxmzRwAe_FdEiS7heUG7bTJLibMP7HHUg=s900-c-k-c0x00ffffff-no-rj",
        "totalSubscribers": 1160000
      },
      {
        "displayName": "🖤 everytime BTS 🖤",
        "uniqueId": "@everytimebts2517",
        "channelId": "UCEi2lZb1oSZ7tDP5vi4U9tg",
        "avatarUrl": "https://yt3.googleusercontent.com/YGNUzzRXD7hvz6Swqgs-NR7sZGiuKodJr15sLdf4tYPMyVXvw3M2ZTN9RJ3psNn5sHmJ3dhxxw=s900-c-k-c0x00ffffff-no-rj",
        "totalSubscribers": 1110000
      }
    ]
  },
  "hasNextPage": true,
  "nextOffset": 10,
  "creditsUsed": 1,
  "creditsAvailable": 975,
  "planCreditsAvailable": 900,
  "purchasedCreditsAvailable": 75,
  "traceId": "f3430ba969f51fc42d633cb4fd00f86d",
  "timestamp": 1767923571340,
  "errorCode": "",
  "errorDescription": "",
  "success": true
}

Authorizations

api-key

string

header

required

The valid CreatorDB API key for authentication.

Body

application/json

YouTube search request parameters.

filters

object[]

required

Filter objects that include filterName, op, and value. For all accepted filterName values and their data types, see Configuring Custom Search Filters and Examples.

Minimum array length: 1

Show child attributes

pageSize

integer

required

Number of results per page. Maximum: 100.

Required range: 1 <= x <= 100

offset

integer

required

Number of records to skip before returning results.

Required range: x >= 0

desc

boolean

Sort order for results. true for descending, false for ascending order.

sortBy

string

Field to sort creators by. For example, totalSubscribers sorts by subscriber count.

fields

object

Enrich each search result with data from other endpoints on the same platform (e.g. profile, contact). Enrichment is billed per result returned, using each endpoint's pricing rules. Each key is a bare endpoint name, and each key's value follows that endpoint's fractional shape. For details, see Field and Item Costs.

Show child attributes

Example:

{
  "profile": ["country"],
  "content-detail": { "recentVideos": 3 },
  "performance-history": { "pastDayRange": 90 },
  "sponsorship": { "sponsorList": 5 }
}

Response

YouTube search results returned successfully.

data

object

required

Search results containing YouTube creators and pagination information.

Show child attributes

creditsUsed

number

required

Number of API credits consumed by this request.

Example:

1

creditsAvailable

number

required

Number of API credits remaining. Equals planCreditsAvailable plus purchasedCreditsAvailable.

Example:

-1

planCreditsAvailable

number

required

Remaining plan credits after this request, in credits.

Example:

900

purchasedCreditsAvailable

number

required

Remaining purchased-bucket credits after this request, in display units.

Example:

75

traceId

string

required

Unique trace ID for each request.

Example:

"f8e4a3b2c1d0e9f8a7b6c5d4e3f2a1b0"

timestamp

integer

required

Time the response was generated, represented as a Unix timestamp in milliseconds.

Example:

1750732453635

errorCode

string

required

Error code returned if the request fails. Empty if the request is successful.

Example:

""

errorDescription

string

required

Description of the error. Empty if the request is successful.

Example:

""

success

boolean

required

true if the request is successful.

Example:

true

keyCreditsAvailable

number

Remaining credits this API key can spend after this request, before reaching its spend limit. Present only when the key has a spend limit.

Example:

4975

enrichment

object

Enrichment status for this request. Present only when fields was supplied.

Show child attributes

Last modified on September 10, 2026

⌘I

cURL

curl -X POST "https://apiv3.creatordb.app/youtube/search" \
  -H "Content-Type: application/json" \
  -H "api-key: <YOUR_API-KEY_HERE>" \
  -d '{
    "filters":[
    {
      "filterName":
        "totalSubscribers",
        "op":">",
        "value":1000000
    }
    ],
    "pageSize":10,
    "offset":0
    }'

const options = {
  method: 'POST',
  headers: {'api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    filters: [{filterName: 'totalSubscribers', op: '>', value: 1000000, isFuzzySearch: true}],
    desc: true,
    sortBy: 'displayName',
    pageSize: 10,
    offset: 0
  })
};

fetch('https://apiv3.creatordb.app/youtube/search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://apiv3.creatordb.app/youtube/search"

payload = {
    "filters": [
        {
            "filterName": "totalSubscribers",
            "op": ">",
            "value": 1000000,
            "isFuzzySearch": True
        }
    ],
    "desc": True,
    "sortBy": "displayName",
    "pageSize": 10,
    "offset": 0
}
headers = {
    "api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://apiv3.creatordb.app/youtube/search",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'filters' => [
        [
                'filterName' => 'totalSubscribers',
                'op' => '>',
                'value' => 1000000,
                'isFuzzySearch' => true
        ]
    ],
    'desc' => true,
    'sortBy' => 'displayName',
    'pageSize' => 10,
    'offset' => 0
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

require 'uri'
require 'net/http'

url = URI("https://apiv3.creatordb.app/youtube/search")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"filters\": [\n    {\n      \"filterName\": \"totalSubscribers\",\n      \"op\": \">\",\n      \"value\": 1000000,\n      \"isFuzzySearch\": true\n    }\n  ],\n  \"desc\": true,\n  \"sortBy\": \"displayName\",\n  \"pageSize\": 10,\n  \"offset\": 0\n}"

response = http.request(request)
puts response.read_body

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://apiv3.creatordb.app/youtube/search"

	payload := strings.NewReader("{\n  \"filters\": [\n    {\n      \"filterName\": \"totalSubscribers\",\n      \"op\": \">\",\n      \"value\": 1000000,\n      \"isFuzzySearch\": true\n    }\n  ],\n  \"desc\": true,\n  \"sortBy\": \"displayName\",\n  \"pageSize\": 10,\n  \"offset\": 0\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://apiv3.creatordb.app/youtube/search")
  .header("api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"filters\": [\n    {\n      \"filterName\": \"totalSubscribers\",\n      \"op\": \">\",\n      \"value\": 1000000,\n      \"isFuzzySearch\": true\n    }\n  ],\n  \"desc\": true,\n  \"sortBy\": \"displayName\",\n  \"pageSize\": 10,\n  \"offset\": 0\n}")
  .asString();

{
  "data": {
    "creatorList": [
      {
        "displayName": "🪐🌍Gallivud_prod",
        "uniqueId": "@gallivud_prod",
        "channelId": "UCMS8ONu5i0tKTyZ4_lLD1DA",
        "avatarUrl": "https://yt3.googleusercontent.com/geeG3ok-_7PzCBlXDEW8Ro2m0QNl_XRH4AekEVvPqBhgmrFJbn2iKzn06lSnI2GnkybvaJY7=s900-c-k-c0x00ffffff-no-rj",
        "totalSubscribers": 1400000
      },
      {
        "displayName": "🪐MILENA MARS🪐",
        "uniqueId": "@milenamars",
        "channelId": "UCjTWFYn4s7fzsonX3Jtw_Ig",
        "avatarUrl": "https://yt3.googleusercontent.com/kFfAtp8wQM5wTqRzFn1wiZWdcJ5atGU1u-BnzpadbVFQJBThObAYNZTxsagdHnzW5m79G5A4pg=s900-c-k-c0x00ffffff-no-rj",
        "totalSubscribers": 2170000
      },
      {
        "displayName": "🩷La Barbie Jimenez 🩷",
        "uniqueId": "@labarbiejimenez",
        "channelId": "UC2Z5u_Azat1RoqK-7-Sy4Tg",
        "avatarUrl": "https://yt3.googleusercontent.com/h6_4n7pOk4AAn93qpxZl0abQZjYtg4PtzxXnsPO3l4wF7p3d8271Q_F_TqeUDsvuQKA6aIPaxYo=s900-c-k-c0x00ffffff-no-rj",
        "totalSubscribers": 1050000
      },
      {
        "displayName": "🦋wishkhanna_🦋",
        "uniqueId": "@wishkhanna____",
        "channelId": "UC32P0rFNpMhz97Oast8Mdgg",
        "avatarUrl": "https://yt3.googleusercontent.com/rubd3-FNnl6pEpm5po_t6J67FE0IV_p452ujgAlxs1QITLGzi-nObStp06dbR3Qz96RJ5gm1=s900-c-k-c0x00ffffff-no-rj",
        "totalSubscribers": 1450000
      },
      {
        "displayName": "🥜𝐀𝐧𝐲𝐚 𝐂𝐡𝐚𝐧🥜",
        "uniqueId": "@yandere79",
        "channelId": "UCVYsu-OqwXh9wF9eHERXcNg",
        "avatarUrl": "https://yt3.googleusercontent.com/kOFqPM33m-b9YLSSjS499UciWpwZMJ0-MLmTjycnBUoGr3OCF2-yH8lMrT4VDgi4XznVX7TA9w=s900-c-k-c0x00ffffff-no-rj",
        "totalSubscribers": 2250000
      },
      {
        "displayName": "🤍cloudy express 🤍",
        "uniqueId": "@cloudyexpress-cb3pf",
        "channelId": "UCo7-sHv2yP_tk2FFbfwmILQ",
        "avatarUrl": "https://yt3.googleusercontent.com/c5pVxWtJhkU12B3D_MS_pfEV-9wpwyxsCHHrOLP67tEQgAf5uNwreDaPHxIqIqS81LIRbjX8w8A=s900-c-k-c0x00ffffff-no-rj",
        "totalSubscribers": 1030000
      },
      {
        "displayName": "🙏Jay shri shyam🙏",
        "uniqueId": "@bhaktisagar609",
        "channelId": "UC2e-a4J25uO7Vqdz5s9D39w",
        "avatarUrl": "https://yt3.googleusercontent.com/1onewDKzTDXArcN-SSOogr_-eGczRvnWi2jlcxMGaxSJq9e8DDMgFwfs7BpaXogQwfFt2Cm3=s900-c-k-c0x00ffffff-no-rj",
        "totalSubscribers": 1810000
      },
      {
        "displayName": "🙏 Pray Together 🙏",
        "uniqueId": "@frastefano",
        "channelId": "UCEISS2bKsVnyvPSGvK-q_mg",
        "avatarUrl": "https://yt3.googleusercontent.com/lqbSpiP1yWva-3v1pbFlZ--tVLaQJuCwGP1vvoAi75-w-VqJe0QDzUxqtfwUfE25Qem15nxy3w=s900-c-k-c0x00ffffff-no-rj",
        "totalSubscribers": 1270000
      },
      {
        "displayName": "🖤BRK",
        "uniqueId": "@mr.say3ed",
        "channelId": "UCCQ7XwHCZetFk0zJWadP1Ww",
        "avatarUrl": "https://yt3.googleusercontent.com/kr5zTRyltQF-7K7iCIiB9iMV1wOmvpRPYvUeIqa_KdxmzRwAe_FdEiS7heUG7bTJLibMP7HHUg=s900-c-k-c0x00ffffff-no-rj",
        "totalSubscribers": 1160000
      },
      {
        "displayName": "🖤 everytime BTS 🖤",
        "uniqueId": "@everytimebts2517",
        "channelId": "UCEi2lZb1oSZ7tDP5vi4U9tg",
        "avatarUrl": "https://yt3.googleusercontent.com/YGNUzzRXD7hvz6Swqgs-NR7sZGiuKodJr15sLdf4tYPMyVXvw3M2ZTN9RJ3psNn5sHmJ3dhxxw=s900-c-k-c0x00ffffff-no-rj",
        "totalSubscribers": 1110000
      }
    ]
  },
  "hasNextPage": true,
  "nextOffset": 10,
  "creditsUsed": 1,
  "creditsAvailable": 975,
  "planCreditsAvailable": 900,
  "purchasedCreditsAvailable": 75,
  "traceId": "f3430ba969f51fc42d633cb4fd00f86d",
  "timestamp": 1767923571340,
  "errorCode": "",
  "errorDescription": "",
  "success": true
}

Getting Started

User Guides

API Endpoints

Filter Value References

Troubleshooting and FAQs

Search Creators

Authorizations

Body

Response