Skip to main content
POST
cURL

Authorizations

api-key
string
header
required

The valid CreatorDB API key for authentication.

Body

application/json
channelId
string

Unique channel ID. Provide exactly one of channelId or uniqueId.

Required string length: 1 - 50
Pattern: ^UC[a-zA-Z0-9_-]{22}$
Example:

"UCBR8-60-B28hp2BmDPdntcQ"

uniqueId
string

YouTube channel handle. Accepts youtube or @youtube format (the @ prefix is optional). Provide exactly one of channelId or uniqueId.

Required string length: 1 - 100
Example:

"@youtube"

fields
object

Map each content array to the number of items to return. Omit or pass an empty object to return all items at the full-bundle price. For per-item costs, see Field and Item Costs.

Response

YouTube content details returned successfully.

data
object
required

Retrieved YouTube content details of a specified creator.

creditsUsed
number
required

Number of API credits consumed by this request.

Example:

1

creditsAvailable
number
required

Number of API credits remaining. Equals planCreditsAvailable plus purchasedCreditsAvailable.

Example:

-1

planCreditsAvailable
number
required

Remaining plan credits after this request, in credits.

Example:

900

purchasedCreditsAvailable
number
required

Remaining purchased-bucket credits after this request, in display units.

Example:

75

traceId
string
required

Unique trace ID for each request.

Example:

"f8e4a3b2c1d0e9f8a7b6c5d4e3f2a1b0"

timestamp
integer
required

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

Example:

1750732453635

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 can spend after this request, before reaching its spend limit. Present only when the key has a spend limit.

Example:

4975

Last modified on September 10, 2026