Natural Language Search

POST

nls

cURL

curl -X POST "https://apiv3.creatordb.app/nls" \
  -H "Content-Type: application/json" \
  -H "api-key: <YOUR_API_KEY_HERE>" \
  -d '{
    "description": "Find US-based YouTube beauty creators that own makeup brands and have more than 15 million subscribers"
  }'

const options = {
  method: 'POST',
  headers: {'api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    description: 'Find US-based YouTube beauty creators that own makeup brands and have more than 15 million subscribers'
  })
};

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

import requests

url = "https://apiv3.creatordb.app/nls"

payload = { "description": "Find US-based YouTube beauty creators that own makeup brands and have more than 15 million subscribers" }
headers = {
    "api-key": "<YOUR_API_KEY_HERE>",
    "Content-Type": "application/json"
}

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

for line in response.iter_lines(decode_unicode=True):
    print(line)

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://apiv3.creatordb.app/nls",
  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([
    'description' => 'Find US-based YouTube beauty creators that own makeup brands and have more than 15 million subscribers'
  ]),
  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/nls")

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  \"description\": \"Find US-based YouTube beauty creators that own makeup brands and have more than 15 million subscribers\"\n}"

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

package main

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

func main() {

	url := "https://apiv3.creatordb.app/nls"

	payload := strings.NewReader("{\n  \"description\": \"Find US-based YouTube beauty creators that own makeup brands and have more than 15 million subscribers\"\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/nls")
  .header("api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"description\": \"Find US-based YouTube beauty creators that own makeup brands and have more than 15 million subscribers\"\n}")
  .asString();

[
  {
    "event": "progress",
    "data": {
      "message": "Loading..."
    }
  },
  {
    "event": "progress",
    "data": {
      "message": "Query validated..."
    }
  },
  {
    "event": "progress",
    "data": {
      "message": "Analyzing intent..."
    }
  },
  {
    "event": "progress",
    "data": {
      "message": "Processing request..."
    }
  },
  {
    "event": "progress",
    "data": {
      "message": "Identifying filters..."
    }
  },
  {
    "event": "progress",
    "data": {
      "message": "Working on it..."
    }
  },
  {
    "event": "progress",
    "data": {
      "message": "Getting the right filters..."
    }
  },
  {
    "event": "progress",
    "data": {
      "message": "Analysis complete..."
    }
  },
  {
    "event": "progress",
    "data": {
      "message": "Putting it all together..."
    }
  },
  {
    "event": "progress",
    "data": {
      "message": "Building query..."
    }
  },
  {
    "event": "progress",
    "data": {
      "message": "Query ready..."
    }
  },
  {
    "event": "result",
    "data": {
      "creatorList": [
        {
          "displayName": "YouTube",
          "uniqueId": "@youtube",
          "channelId": "UCBR8-60-B28hp2BmDPdntcQ",
          "avatarUrl": "https://yt3.googleusercontent.com/3s6evpqAiDU9tQR4sC2siJippbH2RWVPnwHgyl4V0th2iuQz0VDQZbUhQBGmsxLYo-mjG6TqZQ=s900-c-k-c0x00ffffff-no-rj",
          "totalSubscribers": 45000000
        },
        {
          "displayName": "5-Minute Crafts DIY",
          "uniqueId": "@5minutecraftsdiy",
          "channelId": "UC2etEuPIfohP4P53wM0KImA",
          "avatarUrl": "https://yt3.googleusercontent.com/dpw85Qj9vAdE4iX_yr0wUcoZkuBZqPBrlovIkePsgOzmywZdQeJpUQARG1to6mEEeqmUQlMtR-o=s900-c-k-c0x00ffffff-no-rj",
          "totalSubscribers": 20100000
        },
        {
          "displayName": "5-Minute Crafts FAMILY",
          "uniqueId": "@5minutecraftsfamily",
          "channelId": "UC63mNFJR8EAb8wAIJwoCmTA",
          "avatarUrl": "https://yt3.googleusercontent.com/jPrniMECPSuIG45SMTj4VlCxtYqQ4E4RqnZIPxJPPhm_mb1ZHV2X0MFwCh3X6R_3lLvIooVxbNE=s900-c-k-c0x00ffffff-no-rj",
          "totalSubscribers": 15800000
        },
        {
          "displayName": "Kids Diana Show",
          "uniqueId": "@kidsdianashow",
          "channelId": "UCk8GzjMOrta8yxDcKfylJYw",
          "avatarUrl": "https://yt3.googleusercontent.com/G88LBGqFoBWMos0glZEdCvQ7uEMPnhBYsPRMOFX5b5z6tuqWaD6ZcscslaKu0zLO37v8sMUA=s900-c-k-c0x00ffffff-no-rj",
          "totalSubscribers": 138000000
        },
        {
          "displayName": "Maria Clara & JP",
          "uniqueId": "@mariaclaraejp",
          "channelId": "UCKe6w0exI94U-RzqAyoY1VA",
          "avatarUrl": "https://yt3.googleusercontent.com/ytc/AIdro_n8EDt3qdYql9Dt6WAZDlb_7Af8wIukpc3h3cAbCptHNUg=s900-c-k-c0x00ffffff-no-rj",
          "totalSubscribers": 50200000
        },
        {
          "displayName": "Mr DegrEE",
          "uniqueId": "@mrdegreeofficial",
          "channelId": "UCeYTfGpNCmVhlxjQxBDrGPA",
          "avatarUrl": "https://yt3.googleusercontent.com/ytc/AIdro_k8LXkXtQX2Skbr0NZ2jzNO-_j-Bu2T80hWwDUs3eL2ZCg=s900-c-k-c0x00ffffff-no-rj",
          "totalSubscribers": 40400000
        },
        {
          "displayName": "SMOL",
          "uniqueId": "@smol_official",
          "channelId": "UCBBZ7No0AzEJ3qiatjSa-mg",
          "avatarUrl": "https://yt3.googleusercontent.com/QSq4dqpufwELLxjadoLE8CghxJ12tfu4vGUM8t2YiwztzAyYtPvSKN59nH_lEd02vPQfnQ3L2Q=s900-c-k-c0x00ffffff-no-rj",
          "totalSubscribers": 27200000
        },
        {
          "displayName": "Fabiosa Best Lifehacks",
          "uniqueId": "@fabiosabestlifehacks",
          "channelId": "UCF5Rp2ghzXsX6vwYqa7aepg",
          "avatarUrl": "https://yt3.googleusercontent.com/g9YIHarU8-wUSH5lnFRNg9e9RBT9EHv21rlP7r10lHwmpALsDzt-jiSkVzBxTUyDBQjK3Hz1hA=s900-c-k-c0x00ffffff-no-rj",
          "totalSubscribers": 25900000
        },
        {
          "displayName": "James Charles",
          "uniqueId": "@jamescharles",
          "channelId": "UCucot-Zp428OwkyRm2I7v2Q",
          "avatarUrl": "https://yt3.googleusercontent.com/6WC8rRE_1ME7Sza7y-Z75g_wGahOKlyRevH2hOE9DNMrHM37ZYCmNGBnJpJWqhUpy0-c05xQcjk=s900-c-k-c0x00ffffff-no-rj",
          "totalSubscribers": 23900000
        },
        {
          "displayName": "Troom Troom",
          "uniqueId": "@troomtroom",
          "channelId": "UCWwqHwqLSrdWMgp5DZG5Dzg",
          "avatarUrl": "https://yt3.googleusercontent.com/KxkUWubksdvmkXC6dKk_JuJF40McZgmDYWcclmNJHAuhDnZGpVA9-sdW75q9MTCZ-NE2z3yBfY0=s900-c-k-c0x00ffffff-no-rj",
          "totalSubscribers": 23800000
        },
        {
          "displayName": "Marusya Outdoors",
          "uniqueId": "@marusya_outdoors",
          "channelId": "UCRR3vpGoVKF3q_vZI7mCfjQ",
          "avatarUrl": "https://yt3.googleusercontent.com/JNVo_OhRKlrCe4lTIehltRomjHGhAwADSeliVky8KSpwqfeaZ2Y7QCCUiOPVIfFt6XLzCwNE=s900-c-k-c0x00ffffff-no-rj",
          "totalSubscribers": 20600000
        },
        {
          "displayName": "Dr Ryan",
          "uniqueId": "@itsdrryan",
          "channelId": "UC26FEMwAAjj8jfNbuVdFMBQ",
          "avatarUrl": "https://yt3.googleusercontent.com/8XsSINxf0myiTvCb-KByq8eLOQMDg7en6Mxdap1YlbddXyvyBypr5lCaSi98KJhSOCwD9z5gxQ=s900-c-k-c0x00ffffff-no-rj",
          "totalSubscribers": 20000000
        },
        {
          "displayName": "VICE",
          "uniqueId": "@vice",
          "channelId": "UCn8zNIfYAQNdrFRrr8oibKw",
          "avatarUrl": "https://yt3.googleusercontent.com/9AgWUnohXk3gFYvmvAZemlr1q6yd7NxHozeEqrPpJhYf9Crjrvqml0ulZ4PL4v38I4XDoLEhaw=s900-c-k-c0x00ffffff-no-rj",
          "totalSubscribers": 19100000
        },
        {
          "displayName": "Crafty Panda",
          "uniqueId": "@craftypanda",
          "channelId": "UC03RvJoIhm_fMwlUpm9ZvFw",
          "avatarUrl": "https://yt3.googleusercontent.com/ytc/AIdro_kI-gjxVAiZh-LDX0ayqKKSQL-qIxrCG7qi3Q2IQNeTamk=s900-c-k-c0x00ffffff-no-rj",
          "totalSubscribers": 19000000
        },
        {
          "displayName": "Ray William Johnson",
          "uniqueId": "@raywilliamjohnson",
          "channelId": "UCGt7X90Au6BV8rf49BiM6Dg",
          "avatarUrl": "https://yt3.googleusercontent.com/y_myu5CoUFndBkJ5sZFCiSoi-rM6UY-x-Wog6C7nl_6pgXt9M0Z-YPfVCHSvIYS5PlyRidhE=s900-c-k-c0x00ffffff-no-rj",
          "totalSubscribers": 18700000
        },
        {
          "displayName": "JULIA GISELLA",
          "uniqueId": "@juliagisella",
          "channelId": "UCCPsBYxLUykj5xbgOGTRzKQ",
          "avatarUrl": "https://yt3.googleusercontent.com/2n0OZs6fyMF6lvszolH4Pe5s-4koRhrWR7R2julWoeKwnAsLgUTS_6COm0CnGzuf5vIhLvepsNw=s900-c-k-c0x00ffffff-no-rj",
          "totalSubscribers": 18100000
        },
        {
          "displayName": "Jennifer Lopez",
          "uniqueId": "@jenniferlopez",
          "channelId": "UCr8RjWUQ_9KYcIPmWiqBroQ",
          "avatarUrl": "https://yt3.googleusercontent.com/u0IEPhk-hqU3pbeBNAPf5EQRwQs2mnT1-3rRQaGt3pXhf6lhQgFk3j6LQfupRNV0iYIU4BeIQJw=s900-c-k-c0x00ffffff-no-rj",
          "totalSubscribers": 17500000
        },
        {
          "displayName": "Vogue",
          "uniqueId": "@vogue",
          "channelId": "UCRXiA3h1no_PFkb1JCP0yMA",
          "avatarUrl": "https://yt3.googleusercontent.com/pjWEB6VpO5GmzI7aGg6pAjkNSdLf75LKoUXmmj2HAs1Fq1V1zlcevvR4hf7J9VtV7fYxaYJHS8g=s900-c-k-c0x00ffffff-no-rj",
          "totalSubscribers": 16200000
        },
        {
          "displayName": "MrBeast",
          "uniqueId": "@mrbeast",
          "channelId": "UCX6OQ3DkcsbYNE6H8uQQuVA",
          "avatarUrl": "https://yt3.googleusercontent.com/nxYrc_1_2f77DoBadyxMTmv7ZpRZapHR5jbuYe7PlPd5cIRJxtNNEYyOC0ZsxaDyJJzXrnJiuDE=s900-c-k-c0x00ffffff-no-rj",
          "totalSubscribers": 473000000
        },
        {
          "displayName": "Alan's Universe",
          "uniqueId": "@alanchikinchow",
          "channelId": "UC5gxP-2QqIh_09djvlm9Xcg",
          "avatarUrl": "https://yt3.googleusercontent.com/QYrADJNN_BMJSYm0LkqAs13ehWHjtxITE7kSBPsEIB_I_VFeDvujpH4aJfHfJO3FsFMsYa6Oig=s900-c-k-c0x00ffffff-no-rj",
          "totalSubscribers": 100000000
        }
      ],
      "platform": "youtube"
    },
    "traceId": "6ddf6c22a7a84b83e9a98f70a06e6235",
    "timestamp": 1774586488186,
    "creditsAvailable": 2627.89,
    "creditsUsed": 3.04,
    "errorCode": "",
    "errorDescription": "",
    "success": true
  }
]

Authorizations

api-key

string

header

required

The valid CreatorDB API key for authentication.

Body

application/json

Natural language search parameters.

description

string

required

A natural language description of the creators you are looking for.

Required string length: 1 - 1000

Example:

"Find US-based YouTube beauty creators that own makeup brands and have more than 15 million subscribers"

Response

NLS results are delivered via Server-Sent Events (SSE). The stream emits multiple event: progress messages with status updates (e.g., {"message":"Loading..."}, {"message":"Analyzing intent..."}, {"message":"Query ready..."}), followed by a final event: result containing the response object shown below. Connect using an SSE-capable client or stream=True in your HTTP library.

data

object

required

Show child attributes

creditsUsed

number

required

Credits consumed for this request (dynamic, based on token usage).

Example:

3.04

creditsAvailable

number

required

Number of API credits remaining. Equals planCreditsAvailable plus purchasedCreditsAvailable.

Example:

2627.89

planCreditsAvailable

number

required

Remaining plan credits after this request, in credits.

Example:

900

purchasedCreditsAvailable

number

required

Remaining purchased credits after this request, in credits.

Example:

75

traceId

string

required

Unique trace ID for each request.

Example:

"6ddf6c22a7a84b83e9a98f70a06e6235"

timestamp

integer

required

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

Example:

1774586488186

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 may still spend before reaching its spend limit, in credits. Present only when the key has a spend limit.

Example:

4975

⌘I

cURL

curl -X POST "https://apiv3.creatordb.app/nls" \
  -H "Content-Type: application/json" \
  -H "api-key: <YOUR_API_KEY_HERE>" \
  -d '{
    "description": "Find US-based YouTube beauty creators that own makeup brands and have more than 15 million subscribers"
  }'

const options = {
  method: 'POST',
  headers: {'api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    description: 'Find US-based YouTube beauty creators that own makeup brands and have more than 15 million subscribers'
  })
};

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

import requests

url = "https://apiv3.creatordb.app/nls"

payload = { "description": "Find US-based YouTube beauty creators that own makeup brands and have more than 15 million subscribers" }
headers = {
    "api-key": "<YOUR_API_KEY_HERE>",
    "Content-Type": "application/json"
}

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

for line in response.iter_lines(decode_unicode=True):
    print(line)

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://apiv3.creatordb.app/nls",
  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([
    'description' => 'Find US-based YouTube beauty creators that own makeup brands and have more than 15 million subscribers'
  ]),
  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/nls")

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  \"description\": \"Find US-based YouTube beauty creators that own makeup brands and have more than 15 million subscribers\"\n}"

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

package main

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

func main() {

	url := "https://apiv3.creatordb.app/nls"

	payload := strings.NewReader("{\n  \"description\": \"Find US-based YouTube beauty creators that own makeup brands and have more than 15 million subscribers\"\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/nls")
  .header("api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"description\": \"Find US-based YouTube beauty creators that own makeup brands and have more than 15 million subscribers\"\n}")
  .asString();

[
  {
    "event": "progress",
    "data": {
      "message": "Loading..."
    }
  },
  {
    "event": "progress",
    "data": {
      "message": "Query validated..."
    }
  },
  {
    "event": "progress",
    "data": {
      "message": "Analyzing intent..."
    }
  },
  {
    "event": "progress",
    "data": {
      "message": "Processing request..."
    }
  },
  {
    "event": "progress",
    "data": {
      "message": "Identifying filters..."
    }
  },
  {
    "event": "progress",
    "data": {
      "message": "Working on it..."
    }
  },
  {
    "event": "progress",
    "data": {
      "message": "Getting the right filters..."
    }
  },
  {
    "event": "progress",
    "data": {
      "message": "Analysis complete..."
    }
  },
  {
    "event": "progress",
    "data": {
      "message": "Putting it all together..."
    }
  },
  {
    "event": "progress",
    "data": {
      "message": "Building query..."
    }
  },
  {
    "event": "progress",
    "data": {
      "message": "Query ready..."
    }
  },
  {
    "event": "result",
    "data": {
      "creatorList": [
        {
          "displayName": "YouTube",
          "uniqueId": "@youtube",
          "channelId": "UCBR8-60-B28hp2BmDPdntcQ",
          "avatarUrl": "https://yt3.googleusercontent.com/3s6evpqAiDU9tQR4sC2siJippbH2RWVPnwHgyl4V0th2iuQz0VDQZbUhQBGmsxLYo-mjG6TqZQ=s900-c-k-c0x00ffffff-no-rj",
          "totalSubscribers": 45000000
        },
        {
          "displayName": "5-Minute Crafts DIY",
          "uniqueId": "@5minutecraftsdiy",
          "channelId": "UC2etEuPIfohP4P53wM0KImA",
          "avatarUrl": "https://yt3.googleusercontent.com/dpw85Qj9vAdE4iX_yr0wUcoZkuBZqPBrlovIkePsgOzmywZdQeJpUQARG1to6mEEeqmUQlMtR-o=s900-c-k-c0x00ffffff-no-rj",
          "totalSubscribers": 20100000
        },
        {
          "displayName": "5-Minute Crafts FAMILY",
          "uniqueId": "@5minutecraftsfamily",
          "channelId": "UC63mNFJR8EAb8wAIJwoCmTA",
          "avatarUrl": "https://yt3.googleusercontent.com/jPrniMECPSuIG45SMTj4VlCxtYqQ4E4RqnZIPxJPPhm_mb1ZHV2X0MFwCh3X6R_3lLvIooVxbNE=s900-c-k-c0x00ffffff-no-rj",
          "totalSubscribers": 15800000
        },
        {
          "displayName": "Kids Diana Show",
          "uniqueId": "@kidsdianashow",
          "channelId": "UCk8GzjMOrta8yxDcKfylJYw",
          "avatarUrl": "https://yt3.googleusercontent.com/G88LBGqFoBWMos0glZEdCvQ7uEMPnhBYsPRMOFX5b5z6tuqWaD6ZcscslaKu0zLO37v8sMUA=s900-c-k-c0x00ffffff-no-rj",
          "totalSubscribers": 138000000
        },
        {
          "displayName": "Maria Clara & JP",
          "uniqueId": "@mariaclaraejp",
          "channelId": "UCKe6w0exI94U-RzqAyoY1VA",
          "avatarUrl": "https://yt3.googleusercontent.com/ytc/AIdro_n8EDt3qdYql9Dt6WAZDlb_7Af8wIukpc3h3cAbCptHNUg=s900-c-k-c0x00ffffff-no-rj",
          "totalSubscribers": 50200000
        },
        {
          "displayName": "Mr DegrEE",
          "uniqueId": "@mrdegreeofficial",
          "channelId": "UCeYTfGpNCmVhlxjQxBDrGPA",
          "avatarUrl": "https://yt3.googleusercontent.com/ytc/AIdro_k8LXkXtQX2Skbr0NZ2jzNO-_j-Bu2T80hWwDUs3eL2ZCg=s900-c-k-c0x00ffffff-no-rj",
          "totalSubscribers": 40400000
        },
        {
          "displayName": "SMOL",
          "uniqueId": "@smol_official",
          "channelId": "UCBBZ7No0AzEJ3qiatjSa-mg",
          "avatarUrl": "https://yt3.googleusercontent.com/QSq4dqpufwELLxjadoLE8CghxJ12tfu4vGUM8t2YiwztzAyYtPvSKN59nH_lEd02vPQfnQ3L2Q=s900-c-k-c0x00ffffff-no-rj",
          "totalSubscribers": 27200000
        },
        {
          "displayName": "Fabiosa Best Lifehacks",
          "uniqueId": "@fabiosabestlifehacks",
          "channelId": "UCF5Rp2ghzXsX6vwYqa7aepg",
          "avatarUrl": "https://yt3.googleusercontent.com/g9YIHarU8-wUSH5lnFRNg9e9RBT9EHv21rlP7r10lHwmpALsDzt-jiSkVzBxTUyDBQjK3Hz1hA=s900-c-k-c0x00ffffff-no-rj",
          "totalSubscribers": 25900000
        },
        {
          "displayName": "James Charles",
          "uniqueId": "@jamescharles",
          "channelId": "UCucot-Zp428OwkyRm2I7v2Q",
          "avatarUrl": "https://yt3.googleusercontent.com/6WC8rRE_1ME7Sza7y-Z75g_wGahOKlyRevH2hOE9DNMrHM37ZYCmNGBnJpJWqhUpy0-c05xQcjk=s900-c-k-c0x00ffffff-no-rj",
          "totalSubscribers": 23900000
        },
        {
          "displayName": "Troom Troom",
          "uniqueId": "@troomtroom",
          "channelId": "UCWwqHwqLSrdWMgp5DZG5Dzg",
          "avatarUrl": "https://yt3.googleusercontent.com/KxkUWubksdvmkXC6dKk_JuJF40McZgmDYWcclmNJHAuhDnZGpVA9-sdW75q9MTCZ-NE2z3yBfY0=s900-c-k-c0x00ffffff-no-rj",
          "totalSubscribers": 23800000
        },
        {
          "displayName": "Marusya Outdoors",
          "uniqueId": "@marusya_outdoors",
          "channelId": "UCRR3vpGoVKF3q_vZI7mCfjQ",
          "avatarUrl": "https://yt3.googleusercontent.com/JNVo_OhRKlrCe4lTIehltRomjHGhAwADSeliVky8KSpwqfeaZ2Y7QCCUiOPVIfFt6XLzCwNE=s900-c-k-c0x00ffffff-no-rj",
          "totalSubscribers": 20600000
        },
        {
          "displayName": "Dr Ryan",
          "uniqueId": "@itsdrryan",
          "channelId": "UC26FEMwAAjj8jfNbuVdFMBQ",
          "avatarUrl": "https://yt3.googleusercontent.com/8XsSINxf0myiTvCb-KByq8eLOQMDg7en6Mxdap1YlbddXyvyBypr5lCaSi98KJhSOCwD9z5gxQ=s900-c-k-c0x00ffffff-no-rj",
          "totalSubscribers": 20000000
        },
        {
          "displayName": "VICE",
          "uniqueId": "@vice",
          "channelId": "UCn8zNIfYAQNdrFRrr8oibKw",
          "avatarUrl": "https://yt3.googleusercontent.com/9AgWUnohXk3gFYvmvAZemlr1q6yd7NxHozeEqrPpJhYf9Crjrvqml0ulZ4PL4v38I4XDoLEhaw=s900-c-k-c0x00ffffff-no-rj",
          "totalSubscribers": 19100000
        },
        {
          "displayName": "Crafty Panda",
          "uniqueId": "@craftypanda",
          "channelId": "UC03RvJoIhm_fMwlUpm9ZvFw",
          "avatarUrl": "https://yt3.googleusercontent.com/ytc/AIdro_kI-gjxVAiZh-LDX0ayqKKSQL-qIxrCG7qi3Q2IQNeTamk=s900-c-k-c0x00ffffff-no-rj",
          "totalSubscribers": 19000000
        },
        {
          "displayName": "Ray William Johnson",
          "uniqueId": "@raywilliamjohnson",
          "channelId": "UCGt7X90Au6BV8rf49BiM6Dg",
          "avatarUrl": "https://yt3.googleusercontent.com/y_myu5CoUFndBkJ5sZFCiSoi-rM6UY-x-Wog6C7nl_6pgXt9M0Z-YPfVCHSvIYS5PlyRidhE=s900-c-k-c0x00ffffff-no-rj",
          "totalSubscribers": 18700000
        },
        {
          "displayName": "JULIA GISELLA",
          "uniqueId": "@juliagisella",
          "channelId": "UCCPsBYxLUykj5xbgOGTRzKQ",
          "avatarUrl": "https://yt3.googleusercontent.com/2n0OZs6fyMF6lvszolH4Pe5s-4koRhrWR7R2julWoeKwnAsLgUTS_6COm0CnGzuf5vIhLvepsNw=s900-c-k-c0x00ffffff-no-rj",
          "totalSubscribers": 18100000
        },
        {
          "displayName": "Jennifer Lopez",
          "uniqueId": "@jenniferlopez",
          "channelId": "UCr8RjWUQ_9KYcIPmWiqBroQ",
          "avatarUrl": "https://yt3.googleusercontent.com/u0IEPhk-hqU3pbeBNAPf5EQRwQs2mnT1-3rRQaGt3pXhf6lhQgFk3j6LQfupRNV0iYIU4BeIQJw=s900-c-k-c0x00ffffff-no-rj",
          "totalSubscribers": 17500000
        },
        {
          "displayName": "Vogue",
          "uniqueId": "@vogue",
          "channelId": "UCRXiA3h1no_PFkb1JCP0yMA",
          "avatarUrl": "https://yt3.googleusercontent.com/pjWEB6VpO5GmzI7aGg6pAjkNSdLf75LKoUXmmj2HAs1Fq1V1zlcevvR4hf7J9VtV7fYxaYJHS8g=s900-c-k-c0x00ffffff-no-rj",
          "totalSubscribers": 16200000
        },
        {
          "displayName": "MrBeast",
          "uniqueId": "@mrbeast",
          "channelId": "UCX6OQ3DkcsbYNE6H8uQQuVA",
          "avatarUrl": "https://yt3.googleusercontent.com/nxYrc_1_2f77DoBadyxMTmv7ZpRZapHR5jbuYe7PlPd5cIRJxtNNEYyOC0ZsxaDyJJzXrnJiuDE=s900-c-k-c0x00ffffff-no-rj",
          "totalSubscribers": 473000000
        },
        {
          "displayName": "Alan's Universe",
          "uniqueId": "@alanchikinchow",
          "channelId": "UC5gxP-2QqIh_09djvlm9Xcg",
          "avatarUrl": "https://yt3.googleusercontent.com/QYrADJNN_BMJSYm0LkqAs13ehWHjtxITE7kSBPsEIB_I_VFeDvujpH4aJfHfJO3FsFMsYa6Oig=s900-c-k-c0x00ffffff-no-rj",
          "totalSubscribers": 100000000
        }
      ],
      "platform": "youtube"
    },
    "traceId": "6ddf6c22a7a84b83e9a98f70a06e6235",
    "timestamp": 1774586488186,
    "creditsAvailable": 2627.89,
    "creditsUsed": 3.04,
    "errorCode": "",
    "errorDescription": "",
    "success": true
  }
]

Getting Started

User Guides

API Endpoints

Filter Value References

Troubleshooting and FAQs

Authorizations

Body

Response