Skip to main content

​
Path Parameters

​
channel_id
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

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

​
Response

​
channel_id
string
Canonical channel id (UC…).
​
title
string
Channel title (nullable).
​
channel_name
string
Channel display name (nullable).
​
channel_username
string
Channel @handle (nullable).
​
custom_url
string
Custom URL slug (nullable).
​
channel_url
string
Full channel URL (nullable).
​
description
string
Channel description (nullable).
​
description_links
array
Links parsed from the description, with title and url.
​
number_of_subscribers
integer
Subscriber count (nullable).
​
subscriber_count_text
string
Subscriber count as displayed (nullable).
​
hidden_subscriber_count
boolean
Whether the subscriber count is hidden (nullable).
​
channel_total_videos
integer
Total uploaded videos (nullable).
​
channel_total_videos_text
string
Total videos as displayed (nullable).
​
channel_total_views
integer
Total channel views (nullable).
​
channel_total_views_text
string
Total views as displayed (nullable).
​
joined_at
string
ISO 8601 channel creation date (nullable).
​
joined_utc
number
Unix channel creation timestamp (nullable).
​
country
string
Channel country code (nullable).
​
channel_location
string
Channel location text (nullable).
​
keywords
array
Channel keywords.
​
tags
array
Channel tags.
​
is_verified
boolean
Whether the channel is verified (nullable).
​
is_age_restricted
boolean
Whether the channel is age-restricted (nullable).
​
is_family_safe
boolean
Whether the channel is family-safe (nullable).
​
is_monetized
boolean
Whether the channel is monetized (nullable).
​
is_auto_generated
boolean
Whether the channel is auto-generated (nullable).
​
made_for_kids
boolean
Whether the channel is made for kids (nullable).
​
avatar
string
Avatar image URL (nullable).
​
banner
string
Banner image URL (nullable).
​
tv_banner
string
TV banner image URL (nullable).
​
mobile_banner
string
Mobile banner image URL (nullable).
​
avatar_thumbnails
array
Avatar variants with url, width, height.
​
banner_thumbnails
array
Banner variants with url, width, height.
​
external_links
array
External links from the channel header, with title and url.
​
tabs
array
Available channel tabs, e.g. Videos, Shorts, Playlists.
​
available_countries
array
Country codes where the channel is available.
​
related_channels
array
Featured / related channel objects.
​
latest_videos
array
A preview of the channel’s latest videos.
​
scraped_at
string
ISO 8601 timestamp when the channel was scraped.
​
scraped_utc
number
Unix timestamp when the channel was scraped.

​
Example Response

{
  "channel_id": "UCBR8-60-B28hp2BmDPdntcQ",
  "title": "YouTube",
  "channel_name": "YouTube",
  "channel_username": "@YouTube",
  "custom_url": "@YouTube",
  "channel_url": "https://www.youtube.com/@YouTube",
  "description": "YouTube's Official Channel helps you discover what's new & trending globally.",
  "number_of_subscribers": 42000000,
  "subscriber_count_text": "42M subscribers",
  "channel_total_videos": 1200,
  "channel_total_views": 9800000000,
  "joined_at": "2005-09-19T00:00:00Z",
  "country": "US",
  "is_verified": true,
  "is_family_safe": true,
  "avatar": "https://yt3.googleusercontent.com/abc/avatar.jpg",
  "banner": "https://yt3.googleusercontent.com/abc/banner.jpg",
  "tabs": ["Home", "Videos", "Shorts", "Playlists", "Community"],
  "scraped_at": "2026-06-21T12:00:00Z"
}

​
Lightweight Lookups

EndpointDescriptionCost
GET /v1/youtube/channels/{channel_id}/aboutAbout-tab payload only — description, links, stats, joined date, country (ChannelAbout).2 credits
GET /v1/youtube/channels/{channel_id}/subscriber_countFast subscriber-count-only response (SubscriberCount).2 credits
A full channel-detail request costs 5 credits; the /about and /subscriber_count lookups cost 2 credits each. Failed requests are not charged.