getChannelTopVideos
Retrieve the most viewed videos from any YouTube channel to analyze popular content and identify successful video strategies.
Instructions
Retrieves the top videos from a specific channel. Returns a list of the most viewed or popular videos from the channel, based on view count. Use this when you want to identify the most successful content from a channel.
Input Schema
Name | Required | Description | Default |
---|---|---|---|
channelId | Yes | YouTube channel ID to get top videos from | |
descriptionDetail | No | Controls video description detail to manage token cost. Options: 'NONE' (default, no text), 'SNIPPET' (a brief preview for broad scans), 'LONG' (a 500-char text for deep analysis of specific targets). | NONE |
includeTags | No | Specify 'true' to include the video's 'tags' array in the response, which is useful for extracting niche keywords. The 'tags' are omitted by default to conserve tokens. | |
maxResults | No | Maximum number of top videos to return (1-500, default: 10) |
Input Schema (JSON Schema)
{
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"channelId": {
"description": "YouTube channel ID to get top videos from",
"minLength": 1,
"type": "string"
},
"descriptionDetail": {
"default": "NONE",
"description": "Controls video description detail to manage token cost. Options: 'NONE' (default, no text), 'SNIPPET' (a brief preview for broad scans), 'LONG' (a 500-char text for deep analysis of specific targets).",
"enum": [
"NONE",
"SNIPPET",
"LONG"
],
"type": "string"
},
"includeTags": {
"default": false,
"description": "Specify 'true' to include the video's 'tags' array in the response, which is useful for extracting niche keywords. The 'tags' are omitted by default to conserve tokens.",
"type": "boolean"
},
"maxResults": {
"default": 10,
"description": "Maximum number of top videos to return (1-500, default: 10)",
"maximum": 500,
"minimum": 1,
"type": "number"
}
},
"required": [
"channelId"
],
"type": "object"
}