Skip to main content
POST
/
nls
cURL
curl -X POST "https://apiv3.creatordb.app/nls" \
  -H "Content-Type: application/json" \
  -H "api-key: <YOUR_API_KEY>" \
  -d '{
    "description": "Find US-based YouTube beauty creators that own makeup brands and have more than 15 million subscribers"
  }'
[ { "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 } ]

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

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
creditsUsed
number
required

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

Example:

3.04

creditsAvailable
number
required

Number of API credits remaining.

Example:

2627.89

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

Last modified on May 8, 2026