> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scrapebadger.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Get Channel
> Full detail for a YouTube channel — header, About tab, stats, branding, and links.
## Path Parameters
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
Content region (ISO 3166-1 alpha-2). Examples: `US`, `GB`, `DE`, `JP`.
UI / interface language (BCP-47). Examples: `en`, `de`, `fr`, `ja`.
## Response
Canonical channel id (`UC…`).
Channel title (nullable).
Channel display name (nullable).
Channel `@handle` (nullable).
Custom URL slug (nullable).
Full channel URL (nullable).
Channel description (nullable).
Links parsed from the description, with `title` and `url`.
Subscriber count (nullable).
Subscriber count as displayed (nullable).
Whether the subscriber count is hidden (nullable).
Total uploaded videos (nullable).
Total videos as displayed (nullable).
Total channel views (nullable).
Total views as displayed (nullable).
ISO 8601 channel creation date (nullable).
Unix channel creation timestamp (nullable).
Channel country code (nullable).
Channel location text (nullable).
Channel keywords.
Channel tags.
Whether the channel is verified (nullable).
Whether the channel is age-restricted (nullable).
Whether the channel is family-safe (nullable).
Whether the channel is monetized (nullable).
Whether the channel is auto-generated (nullable).
Whether the channel is made for kids (nullable).
Avatar image URL (nullable).
Banner image URL (nullable).
TV banner image URL (nullable).
Mobile banner image URL (nullable).
Avatar variants with `url`, `width`, `height`.
Banner variants with `url`, `width`, `height`.
External links from the channel header, with `title` and `url`.
Available channel tabs, e.g. `Videos`, `Shorts`, `Playlists`.
Country codes where the channel is available.
Featured / related channel objects.
A preview of the channel's latest videos.
ISO 8601 timestamp when the channel was scraped.
Unix timestamp when the channel was scraped.
### Example Response
```json theme={null}
{
"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
| Endpoint | Description | Cost |
| -------------------------------------------------------- | ------------------------------------------------------------------------------------------ | --------- |
| `GET /v1/youtube/channels/{channel_id}/about` | About-tab payload only — description, links, stats, joined date, country (`ChannelAbout`). | 2 credits |
| `GET /v1/youtube/channels/{channel_id}/subscriber_count` | Fast 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.