Read YouTube
youtube_readRead YouTube channel data from a connected Upload-Post account, including videos, playlists, comments, captions, analytics, and live streams for monitoring and reporting.
Instructions
Read-only YouTube data of the connected channel. Fields go in params with the API's names; lists page with max_results and page_token. videos (ids up to 50, parts, include_owner_details: status, processing, statistics, translations); quota (the account's allowance left today); rating (ids: the channel's like/dislike); playlists (ids or channel_id), playlist_items (playlist_id), playlist_image (playlist_id); captions (video_id: caption tracks); comments (video_id, or scope: channel for the whole channel; moderation_status published|heldForReview|likelySpam, order, search, include_replies), comment_replies (parent_id); search (q, for_mine, channel_id, type video|channel|playlist, order, published_after…; few searches per day: free plan 1, paid 5), categories (region), languages, regions; channel (settings, branding, translations, statistics), channel_lookup (for_handle, ids), channel_sections, subscriptions (filter mine|my_subscribers), activities; broadcasts (status active|upcoming|completed), broadcast (broadcast_id), streams, stream (stream_id; include_stream_key returns the secret key to the owner), live_chat (broadcast_id or live_chat_id, page_token; wait polling_interval_ms between reads), super_chats. Every call spends the account's daily YouTube allowance (free plan 200 units, paid plans 2,000; resets at midnight Pacific time; youtube_read quota shows what is left): reads cost about 1 unit, most writes 50, captions 400-450, so batch reads and avoid needless writes.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"action": "<action>"
},
"name": "youtube_read"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| user | No | Upload-Post profile name with YouTube connected (not needed for quota and catalogs). | |
| action | Yes | ||
| params | No | Other API fields for this action, with the REST API's own names (snake_case) and shapes. See the description for each action's fields. Leave out what you do not want to change. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | No |