Get Channel
youtube_get_channelRetrieve public channel details including title, description, subscriber count, and video count by providing a channel ID, @handle, or legacy username.
Instructions
Retrieve public details for any YouTube channel by one of three identifiers: channel ID, @handle, or legacy username. Exactly one of channelId, handle, or username must be supplied.
Args:
channelId(optional): The channel's unique ID, e.g."UCxxxxxxxx".handle(optional): The channel's @handle. The leading@is stripped automatically, e.g."@MrBeast"or"MrBeast".username(optional): A legacy YouTube username (deprecated by YouTube but still supported), e.g."PewDiePie".response_format(optional):"markdown"(default) or"json".
Returns (JSON shape):
{
"id": "UCxxxxxxxx",
"snippet": { "title", "description", "customUrl", "publishedAt", "country", "thumbnails" },
"statistics": { "subscriberCount", "videoCount", "viewCount", "commentCount" },
"brandingSettings": { "channel": { "title", "description", "keywords" } },
"contentDetails": { "relatedPlaylists": { "uploads" } }
}Examples:
"Look up channel UCxxxxxxxx" → pass
channelId: "UCxxxxxxxx"."Get info on @MrBeast" → pass
handle: "@MrBeast"."Find channel for username PewDiePie" → pass
username: "PewDiePie".
Errors:
400: none of the three identifiers was provided.
404: channel not found or not publicly accessible.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| channelId | No | YouTube channel ID, e.g. UCxxxxxxxx. Provide exactly one of channelId, handle, or username. | |
| handle | No | Channel @handle, e.g. "@MrBeast" or "MrBeast". The leading @ is stripped automatically. | |
| username | No | Legacy YouTube username (deprecated). Provide exactly one of channelId, handle, or username. | |
| response_format | No | Output format: "markdown" (default) for a human-readable summary, "json" for the raw API object. | markdown |