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"
  }'
{
  "data": {
    "creatorList": [
      {
        "displayName": "<string>",
        "uniqueId": "<string>",
        "channelId": "<string>",
        "avatarUrl": "<string>",
        "totalSubscribers": 123,
        "totalFollowers": 123
      }
    ],
    "platform": "youtube",
    "message": "<string>",
    "suggestion": [
      "<string>"
    ]
  },
  "creditsUsed": 123,
  "creditsAvailable": 123,
  "traceId": "<string>",
  "timestamp": 123,
  "errorCode": "<string>",
  "errorDescription": "<string>",
  "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 delivered via Server-Sent Events (SSE). The stream includes progress events followed by a final result event containing either a creator list or query suggestions.

data
object
creditsUsed
number

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

Example:

3

creditsAvailable
number

Remaining available credits.

Example:

997

traceId
string

Unique identifier for the request.

Example:

"02a03542233eff21e4a781c9a5090e18"

timestamp
integer

Time the response was generated (Unix timestamp in milliseconds).

Example:

1770099403116

errorCode
string

Error code if the request fails. Empty on success.

Example:

""

errorDescription
string

Error description if the request fails. Empty on success.

Example:

""

success
boolean

Whether the request completed successfully.

Example:

true

Last modified on March 26, 2026