Skip to main content

Path Parameters

string
required
The channel identifier. Accepts a canonical channel id (UC…), an @handle, or a custom URL slug. Handles and custom URLs are resolved automatically.Examples: UCBR8-60-B28hp2BmDPdntcQ, @YouTube, youtube

Query Parameters

string
default:"US"
Content region (ISO 3166-1 alpha-2). Examples: US, GB, DE, JP.
string
default:"en"
UI / interface language (BCP-47). Examples: en, de, fr, ja.

Response

string
Canonical channel id (UC…).
string
Channel title (nullable).
string
Channel display name (nullable).
string
Channel @handle (nullable).
string
Custom URL slug (nullable).
string
Full channel URL (nullable).
string
Channel description (nullable).
Links parsed from the description, with title and url.
integer
Subscriber count (nullable).
string
Subscriber count as displayed (nullable).
boolean
Whether the subscriber count is hidden (nullable).
integer
Total uploaded videos (nullable).
string
Total videos as displayed (nullable).
integer
Total channel views (nullable).
string
Total views as displayed (nullable).
string
ISO 8601 channel creation date (nullable).
number
Unix channel creation timestamp (nullable).
string
Channel country code (nullable).
string
Channel location text (nullable).
array
Channel keywords.
array
Channel tags.
boolean
Whether the channel is verified (nullable).
boolean
Whether the channel is age-restricted (nullable).
boolean
Whether the channel is family-safe (nullable).
boolean
Whether the channel is monetized (nullable).
boolean
Whether the channel is auto-generated (nullable).
boolean
Whether the channel is made for kids (nullable).
string
Avatar image URL (nullable).
string
Banner image URL (nullable).
string
TV banner image URL (nullable).
string
Mobile banner image URL (nullable).
array
Avatar variants with url, width, height.
array
Banner variants with url, width, height.
External links from the channel header, with title and url.
array
Available channel tabs, e.g. Videos, Shorts, Playlists.
array
Country codes where the channel is available.
Featured / related channel objects.
array
A preview of the channel’s latest videos.
string
ISO 8601 timestamp when the channel was scraped.
number
Unix timestamp when the channel was scraped.

Example Response

Lightweight Lookups

A full channel-detail request costs 5 credits; the /about and /subscriber_count lookups cost 2 credits each. Failed requests are not charged.