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. 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

Last modified on September 10, 2026