Skip to main content
POST
cURL

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 July 28, 2026