Skip to main content
GET
cURL

Authorizations

api-key
string
header
required

The valid CreatorDB API key for authentication.

Query Parameters

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"

pastDayRange
string
required

Returns one data point per day over the requested range. For example, 30 returns the past 30 days of daily snapshots. Valid range: 1-365.

Pattern: ^[1-9]\d*$
Example:

"30"

Response

YouTube creator performance historical data returned successfully.

data
object
required

The YouTube performance historical data.

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