Skip to main content
POST
/
youtube
/
search
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
    }'
{
  "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": -1,
  "traceId": "f3430ba969f51fc42d633cb4fd00f86d",
  "timestamp": 1767923571340,
  "errorCode": "",
  "errorDescription": "",
  "success": true
}

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.

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.

Maximum array length: 10
​
pageSize
integer
required

Specifies the maximum number of results to return in a single response. The upper limit is 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.

Response

YouTube search results returned successfully.

​
data
object
required

Search results containing YouTube creators and pagination information.

​
creditsUsed
integer
required

Number of API credits consumed by this request.

Example:

1

​
creditsAvailable
integer
required

Number of API credits remaining. Returns -1 if the quota is unlimited.

Example:

-1

​
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

Last modified on May 8, 2026