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:

"UCX6OQ3DkcsbYNE6H8uQQuVA"

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
enum<string>[]

Subset of profile fields to return for fractional billing. Omit or pass an empty array to return the full profile at the full-bundle price. For details, see Field and Item Costs.

Available options:
channelId,
uniqueId,
displayName,
categoryBreakdown,
avatarUrl,
bio,
isVerified,
hasSponsors,
hasMemberOnlyContents,
country,
mainLanguage,
languages,
secondLanguage,
totalContents,
totalSubscribers,
subscriberGrowth,
hashtags,
topics,
niches,
otherLinks,
lastPublishTime,
relatedCreators,
lastDbUpdateTime
Example:

Response

YouTube creator profile information returned successfully.

data
object
required

Profile information of the 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