Get channel
getChannel(id, query?, options?): Channel
GET
https://api.ytapi.dev/v1/channels/{id}
1 Credit
Handles such as @MrBeast and 24-character channel IDs (UC...) are resolved automatically.
Security
API Key
All requests require a valid API key from the developer dashboard.
Headers: Authorization: Bearer YOUR_API_KEYorX-API-Key: YOUR_API_KEY
See Authentication for headers and rate limits.
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
idpath | string | Yes | Channel handle (for example |
Response (HTTP 200)
{
"channel_id": string, // Canonical 24-character channel ID (UC...)
"title": string, // Channel display name
"handle": string, // Public handle, including @
"description": string, // Channel about text
"subscriber_count": number, // Approximate subscriber count
"subscriber_count_text": string, // Formatted subscriber display string (e.g. "318M subscribers")
"custom_url": string, // Canonical channel URL (e.g. "https://www.youtube.com/@MrBeast")
"country": string, // ISO country code of the channel (when exposed)
"video_count": number, // Public upload count
"verified": boolean, // Whether channel has verified badge
"thumbnails": [ // Avatar image variants
{
"url": string,
"width": number,
"height": number
}
],
"banners": [ // Channel banner image variants
{
"url": string,
"width": number,
"height": number
}
],
"links": string[], // External links from the channel page
"available_tabs": string[] // Available tabs (videos, shorts, streams, playlists)
}