YouTube
Manage multiple YouTube channels, videos, playlists, comments, and live content
OAuth51 native toolsIcon needs-review
This catalogue entry describes the current repository definition. Availability, scopes, and production readiness should be confirmed during private-beta onboarding.
Native tools
GET
youtube_get_channel_activities
Get recent uploads, playlist changes, likes, and other activities for a channel.
/activities
5 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| channelId | string | required | YouTube channel ID. |
| part | string | optional | Comma-separated YouTube resource parts to return. |
| pageToken | string | optional | Pagination token returned by the previous request. |
| maxResults | integer | optional | Maximum number of items to return. |
| fields | string | optional | Optional partial-response fields expression. |
GET
youtube_get_channel_id_by_handle
Resolve a YouTube handle such as @Google to its channel ID.
/channels
1 parameter
| Param | Type | Required | Description |
|---|---|---|---|
| channel_handle | string | required | YouTube channel handle, with or without the @ prefix. |
GET
youtube_get_channel_statistics
Get subscriber, view, and video counts for one or more YouTube channels.
/channels
8 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| id | string | optional | Comma-separated channel IDs. |
| forHandle | string | optional | Channel handle, with or without @. |
| forUsername | string | optional | Legacy YouTube username. |
| mine | boolean | optional | Return channels owned by the authenticated account. |
| part | string | optional | Comma-separated YouTube resource parts to return. |
| pageToken | string | optional | Pagination token returned by the previous request. |
| maxResults | integer | optional | Maximum number of items to return. |
| fields | string | optional | Optional partial-response fields expression. |
GET
youtube_get_video_details_batch
Get details and statistics for one or more YouTube videos.
/videos
5 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| id | string | required | Comma-separated YouTube video IDs. |
| part | string | optional | Comma-separated YouTube resource parts to return. |
| pageToken | string | optional | Pagination token returned by the previous request. |
| maxResults | integer | optional | Maximum number of items to return. |
| fields | string | optional | Optional partial-response fields expression. |
GET
youtube_get_video_rating
Get the authenticated account's rating for one or more videos.
/videos/getRating
1 parameter
| Param | Type | Required | Description |
|---|---|---|---|
| id | string | required | Comma-separated YouTube video IDs. |
GET
youtube_list_caption_track
List caption tracks available for a YouTube video.
/captions
5 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| videoId | string | required | YouTube video ID. |
| part | string | optional | Comma-separated YouTube resource parts to return. |
| pageToken | string | optional | Pagination token returned by the previous request. |
| maxResults | integer | optional | Maximum number of items to return. |
| fields | string | optional | Optional partial-response fields expression. |
GET
youtube_list_channels
List channels visible to the authenticated account or matching a filter.
/channels
9 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| id | string | optional | Comma-separated channel IDs. |
| forHandle | string | optional | Channel handle, with or without @. |
| forUsername | string | optional | Legacy YouTube username. |
| mine | boolean | optional | Return channels owned by the authenticated account. |
| managedByMe | boolean | optional | Return channels managed by the authenticated account. |
| part | string | optional | Comma-separated YouTube resource parts to return. |
| pageToken | string | optional | Pagination token returned by the previous request. |
| maxResults | integer | optional | Maximum number of items to return. |
| fields | string | optional | Optional partial-response fields expression. |
GET
youtube_list_channel_sections
List sections configured on a YouTube channel.
/channelSections
7 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| id | string | optional | Comma-separated channel section IDs. |
| channelId | string | optional | YouTube channel ID. |
| mine | boolean | optional | Use the authenticated channel. |
| part | string | optional | Comma-separated YouTube resource parts to return. |
| pageToken | string | optional | Pagination token returned by the previous request. |
| maxResults | integer | optional | Maximum number of items to return. |
| fields | string | optional | Optional partial-response fields expression. |
GET
youtube_list_channel_videos
List videos published by a YouTube channel, restricted to video results.
/search
7 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| channelId | string | required | YouTube channel ID. |
| q | string | optional | Optional search text. |
| order | string | optional | Search ordering. |
| part | string | optional | Comma-separated YouTube resource parts to return. |
| pageToken | string | optional | Pagination token returned by the previous request. |
| maxResults | integer | optional | Maximum number of items to return. |
| fields | string | optional | Optional partial-response fields expression. |
GET
youtube_list_comments
List comments for a comment thread or comment ID.
/comments
7 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| id | string | optional | Comma-separated comment IDs. |
| parentId | string | optional | Parent comment ID. |
| textFormat | string | optional | plainText or html. |
| part | string | optional | Comma-separated YouTube resource parts to return. |
| pageToken | string | optional | Pagination token returned by the previous request. |
| maxResults | integer | optional | Maximum number of items to return. |
| fields | string | optional | Optional partial-response fields expression. |
GET
youtube_list_comment_threads
List top-level comment threads for a video or channel.
/commentThreads
8 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| videoId | string | optional | YouTube video ID. |
| channelId | string | optional | YouTube channel ID. |
| order | string | optional | relevance or time. |
| textFormat | string | optional | plainText or html. |
| part | string | optional | Comma-separated YouTube resource parts to return. |
| pageToken | string | optional | Pagination token returned by the previous request. |
| maxResults | integer | optional | Maximum number of items to return. |
| fields | string | optional | Optional partial-response fields expression. |
GET
youtube_list_comment_threads2
List comment threads using the complete YouTube comment thread filter set.
/commentThreads
12 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| id | string | optional | Comma-separated comment thread IDs. |
| videoId | string | optional | YouTube video ID. |
| channelId | string | optional | YouTube channel ID. |
| allThreadsRelatedToChannelId | string | optional | Channel ID for all related threads. |
| searchTerms | string | optional | Search text for comments. |
| moderationStatus | string | optional | Moderation status filter. |
| order | string | optional | relevance or time. |
| textFormat | string | optional | plainText or html. |
| part | string | optional | Comma-separated YouTube resource parts to return. |
| pageToken | string | optional | Pagination token returned by the previous request. |
| maxResults | integer | optional | Maximum number of items to return. |
| fields | string | optional | Optional partial-response fields expression. |
GET
youtube_list_i18n_languages
List YouTube languages supported by the API.
/i18nLanguages
5 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| hl | string | optional | Language code used for localized names. |
| part | string | optional | Comma-separated YouTube resource parts to return. |
| pageToken | string | optional | Pagination token returned by the previous request. |
| maxResults | integer | optional | Maximum number of items to return. |
| fields | string | optional | Optional partial-response fields expression. |
GET
youtube_list_i18n_regions
List regions where YouTube is available.
/i18nRegions
5 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| hl | string | optional | Language code used for localized names. |
| part | string | optional | Comma-separated YouTube resource parts to return. |
| pageToken | string | optional | Pagination token returned by the previous request. |
| maxResults | integer | optional | Maximum number of items to return. |
| fields | string | optional | Optional partial-response fields expression. |
GET
youtube_list_live_chat_messages
List messages from a live chat.
/liveChat/messages
6 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| liveChatId | string | required | YouTube live chat ID. |
| profileImageSize | integer | optional | Requested profile image size. |
| part | string | optional | Comma-separated YouTube resource parts to return. |
| pageToken | string | optional | Pagination token returned by the previous request. |
| maxResults | integer | optional | Maximum number of items to return. |
| fields | string | optional | Optional partial-response fields expression. |
GET
youtube_list_most_popular_videos
List currently popular videos by region, category, or both.
/videos
6 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| regionCode | string | optional | ISO 3166-1 alpha-2 region code. |
| videoCategoryId | string | optional | YouTube video category ID. |
| part | string | optional | Comma-separated YouTube resource parts to return. |
| pageToken | string | optional | Pagination token returned by the previous request. |
| maxResults | integer | optional | Maximum number of items to return. |
| fields | string | optional | Optional partial-response fields expression. |
GET
youtube_list_playlist_images
List images associated with a YouTube playlist.
/playlistImages
5 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| playlistId | string | required | YouTube playlist ID. |
| part | string | optional | Comma-separated YouTube resource parts to return. |
| pageToken | string | optional | Pagination token returned by the previous request. |
| maxResults | integer | optional | Maximum number of items to return. |
| fields | string | optional | Optional partial-response fields expression. |
GET
youtube_list_playlist_items
List videos and resources in a YouTube playlist.
/playlistItems
6 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| playlistId | string | required | YouTube playlist ID. |
| videoId | string | optional | Filter by video ID. |
| part | string | optional | Comma-separated YouTube resource parts to return. |
| pageToken | string | optional | Pagination token returned by the previous request. |
| maxResults | integer | optional | Maximum number of items to return. |
| fields | string | optional | Optional partial-response fields expression. |
GET
youtube_list_super_chat_events
List Super Chat and Super Sticker events for a channel.
/superChatEvents?part=id,snippet
3 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| hl | string | optional | Language code for localized content. |
| pageToken | string | optional | Pagination token returned by the previous request. |
| maxResults | integer | optional | Maximum number of items to return. |
GET
youtube_list_user_playlists
List playlists owned by the authenticated YouTube account.
/playlists
5 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| mine | boolean | optional | Return playlists owned by the authenticated account. |
| part | string | optional | Comma-separated YouTube resource parts to return. |
| pageToken | string | optional | Pagination token returned by the previous request. |
| maxResults | integer | optional | Maximum number of items to return. |
| fields | string | optional | Optional partial-response fields expression. |
GET
youtube_list_user_subscriptions
List channels subscribed to by the authenticated account.
/subscriptions
6 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| mine | boolean | optional | Return subscriptions for the authenticated account. |
| channelId | string | optional | Filter by channel ID. |
| part | string | optional | Comma-separated YouTube resource parts to return. |
| pageToken | string | optional | Pagination token returned by the previous request. |
| maxResults | integer | optional | Maximum number of items to return. |
| fields | string | optional | Optional partial-response fields expression. |
GET
youtube_list_video_abuse_report_reasons
List reasons that can be used when reporting a video.
/videoAbuseReportReasons
5 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| hl | string | optional | Language code for localized reason text. |
| part | string | optional | Comma-separated YouTube resource parts to return. |
| pageToken | string | optional | Pagination token returned by the previous request. |
| maxResults | integer | optional | Maximum number of items to return. |
| fields | string | optional | Optional partial-response fields expression. |
GET
youtube_list_video_categories
List YouTube video categories.
/videoCategories
7 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| id | string | optional | Comma-separated category IDs. |
| regionCode | string | optional | ISO 3166-1 alpha-2 region code. |
| hl | string | optional | Language code for localized names. |
| part | string | optional | Comma-separated YouTube resource parts to return. |
| pageToken | string | optional | Pagination token returned by the previous request. |
| maxResults | integer | optional | Maximum number of items to return. |
| fields | string | optional | Optional partial-response fields expression. |
GET
youtube_load_captions
Download a caption track in the requested format and language.
/captions/{captionId}
3 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| captionId | string | required | YouTube caption track ID. |
| tfmt | string | optional | Caption format such as sbv, srt, or vtt. |
| tlang | string | optional | Translation language code. |
GET
youtube_search_you_tube
Search YouTube videos, channels, or playlists.
/search
12 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| q | string | required | Search query. |
| type | string | optional | Resource types to search: video, channel, playlist. |
| order | string | optional | Search ordering. |
| channelId | string | optional | Restrict results to a channel. |
| regionCode | string | optional | ISO 3166-1 alpha-2 region code. |
| publishedAfter | string | optional | RFC 3339 lower publication bound. |
| publishedBefore | string | optional | RFC 3339 upper publication bound. |
| relevanceLanguage | string | optional | Preferred relevance language. |
| part | string | optional | Comma-separated YouTube resource parts to return. |
| pageToken | string | optional | Pagination token returned by the previous request. |
| maxResults | integer | optional | Maximum number of items to return. |
| fields | string | optional | Optional partial-response fields expression. |
POST
youtube_add_video_to_playlist
Add a video to a YouTube playlist.
/playlistItems?part=snippet
3 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| playlistId | string | required | YouTube playlist ID. |
| videoId | string | required | YouTube video ID. |
| position | string | optional | Zero-based playlist position. |
POST
youtube_create_channel_section
Create a section on the authenticated YouTube channel.
/channelSections?part=snippet,contentDetails
2 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| snippet | object | required | Channel section snippet resource. |
| contentDetails | object | optional | Channel section content details resource. |
POST
youtube_create_comment_reply
Reply to an existing YouTube comment.
/comments?part=snippet
2 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| parentId | string | required | Parent YouTube comment ID. |
| textOriginal | string | required | Reply text. |
POST
youtube_create_playlist
Create a playlist on the authenticated YouTube channel.
/playlists?part=snippet,status
3 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| title | string | required | Playlist title. |
| description | string | optional | Playlist description. |
| privacyStatus | string | optional | YouTube privacy status. |
DELETE
youtube_delete_channel_section
Delete a channel section owned by the authenticated account.
/channelSections
1 parameter
| Param | Type | Required | Description |
|---|---|---|---|
| id | string | required | Channel section ID. |
DELETE
youtube_delete_comment
Delete a comment owned by the authenticated account.
/comments
1 parameter
| Param | Type | Required | Description |
|---|---|---|---|
| id | string | required | Comment ID. |
DELETE
youtube_delete_playlist
Permanently delete a playlist owned by the authenticated account.
/playlists
2 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| id | string | required | Playlist ID. |
| confirmDelete | boolean | required | Must be true to confirm this permanent deletion. |
DELETE
youtube_delete_playlist_item
Remove a video from a playlist.
/playlistItems
1 parameter
| Param | Type | Required | Description |
|---|---|---|---|
| id | string | required | Playlist item ID. |
DELETE
youtube_delete_video
Permanently delete a video owned by the authenticated account.
/videos
2 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| id | string | required | Video ID. |
| confirmDelete | boolean | required | Must be true to confirm this permanent deletion. |
POST
youtube_mark_comment_as_spam
Mark a YouTube comment as spam.
/comments/markAsSpam
1 parameter
| Param | Type | Required | Description |
|---|---|---|---|
| id | string | required | Comment ID. |
POST
youtube_multipart_upload_video
Upload video metadata and media using YouTube's multipart upload flow.
/videos
3 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| body | object | required | YouTube video resource metadata. |
| media | object | required | Video bytes as base64 plus their MIME type. |
| part | string | required | Resource parts included in metadata. |
POST
youtube_post_comment
Post a top-level comment on a YouTube video.
/commentThreads?part=snippet
3 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| videoId | string | required | Video ID. |
| channelId | string | required | Video channel ID. |
| textOriginal | string | required | Comment text. |
POST
youtube_rate_video
Set or clear the authenticated account's rating for a video.
/videos/rate
2 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| id | string | required | Video ID. |
| rating | string | required | like, dislike, or none. |
POST
youtube_report_video_abuse
Report a YouTube video for an abuse reason.
/videos/reportAbuse
4 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| videoId | string | required | Video ID. |
| reasonId | string | required | Video abuse report reason ID. |
| secondaryReasonId | string | optional | Optional secondary reason ID. |
| comments | string | optional | Optional report comments. |
POST
youtube_set_comment_moderation_status
Set the moderation status for one or more comments.
/comments/setModerationStatus
4 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| id | string | required | Comma-separated comment IDs. |
| moderationStatus | string | required | heldForReview, published, or rejected. |
| banAuthor | boolean | optional | Ban the comment author when rejecting. |
| comments | string | optional | Optional moderation note. |
POST
youtube_subscribe_channel
Subscribe the authenticated YouTube account to a channel.
/subscriptions?part=snippet
1 parameter
| Param | Type | Required | Description |
|---|---|---|---|
| channelId | string | required | Channel ID to subscribe to. |
DELETE
youtube_unsubscribe_channel
Remove a subscription owned by the authenticated account.
/subscriptions
1 parameter
| Param | Type | Required | Description |
|---|---|---|---|
| id | string | required | Subscription ID. |
PUT
youtube_update_caption
Update a YouTube caption track's metadata.
/captions?part=snippet
3 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| id | string | required | Caption track ID. |
| name | string | optional | Caption track name. |
| isDraft | boolean | optional | Whether the caption is a draft. |
PUT
youtube_update_channel
Update a channel resource owned by the authenticated account.
/channels
2 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| channel | object | required | Complete YouTube channel resource. |
| part | string | required | Comma-separated channel resource parts. |
PUT
youtube_update_channel_section
Update a channel section owned by the authenticated account.
/channelSections
2 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| channelSection | object | required | Complete YouTube channel section resource. |
| part | string | required | Comma-separated channel section parts. |
PUT
youtube_update_comment
Update a comment owned by the authenticated account.
/comments
2 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| comment | object | required | Complete YouTube comment resource. |
| part | string | required | Comma-separated comment resource parts. |
PUT
youtube_update_playlist
Update a playlist's title, description, or privacy status.
/playlists?part=snippet,status
4 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| playlistId | string | required | Playlist ID. |
| title | string | optional | Updated playlist title. |
| description | string | optional | Updated playlist description. |
| privacyStatus | string | optional | YouTube privacy status. |
PUT
youtube_update_playlist_item
Update a playlist item owned by the authenticated account.
/playlistItems
2 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| playlistItem | object | required | Complete YouTube playlist item resource. |
| part | string | required | Comma-separated playlist item parts. |
POST
youtube_update_thumbnail
Set a custom thumbnail for a YouTube video.
/thumbnails/set
2 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| videoId | string | required | Video ID. |
| image | object | required | Thumbnail bytes as base64 plus their MIME type. |
PUT
youtube_update_video
Update a video's metadata, tags, category, or privacy status.
/videos?part=snippet,status
6 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| videoId | string | required | Video ID. |
| title | string | optional | Updated title. |
| description | string | optional | Updated description. |
| tags | array | optional | Video tags. |
| categoryId | string | optional | Video category ID. |
| privacyStatus | string | optional | YouTube privacy status. |
POST
youtube_upload_video
Upload a video and its metadata to the authenticated YouTube channel.
/videos
3 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| body | object | required | YouTube video metadata resource. |
| media | object | required | Video bytes as base64 plus their MIME type. |
| part | string | required | Resource parts included in metadata. |