- Category: video & audio
- Auth: OAUTH2
- Composio-managed OAuth available? Yes
- Tools: 61
- Triggers: 4
- Slug:
YOUTUBE - Version: 20261101_00
Frequently Asked Questions
How do I set up custom Google OAuth credentials for YouTube?
How do I set up custom Google OAuth credentials for YouTube?
Why am I getting quota errors on YouTube?
Why am I getting quota errors on YouTube?
Tools
Add Video to Playlist
Add Video to Playlist
YOUTUBE_ADD_VIDEO_TO_PLAYLISTTool to add a video to a playlist by inserting a playlist item. Use when organizing videos into playlists or building curated collections.Input Parameters
Output
Insert Channel Section
Insert Channel Section
YOUTUBE_CREATE_CHANNEL_SECTIONTool to create a new channel section for the authenticated user’s YouTube channel. Use when organizing channel content into sections like featured playlists, recent uploads, or featured channels.Input Parameters
Output
Insert Comment Reply
Insert Comment Reply
YOUTUBE_CREATE_COMMENT_REPLYTool to create a reply to an existing YouTube comment. Use when responding to user comments or engaging in conversations on videos.Input Parameters
Output
Create Playlist
Create Playlist
YOUTUBE_CREATE_PLAYLISTTool to create a new YouTube playlist on the authenticated user’s channel. Use when organizing videos into collections or building curated playlists.Input Parameters
Output
Delete caption track
Delete caption track
YOUTUBE_DELETE_CAPTION_TRACKPermanently deletes an owned caption track after explicit confirmation with confirmDelete: true.Input Parameters
Output
Delete Channel Section
Delete Channel Section
YOUTUBE_DELETE_CHANNEL_SECTIONDeletes a YouTube channel section by ID, subject to permission. The result reports whether deletion succeeded; HTTP 400, 403, and 404 are returned as structured failures.Input Parameters
Output
Delete Comment
Delete Comment
YOUTUBE_DELETE_COMMENTDeletes a YouTube comment by ID, subject to authorization. The result reports whether deletion succeeded; HTTP 400, 403, and 404 are returned as structured failures.Input Parameters
Output
Delete Live Broadcast
Delete Live Broadcast
YOUTUBE_DELETE_LIVE_BROADCASTPermanently delete an owned YouTube live broadcast after confirmation.Input Parameters
Output
Delete Playlist
Delete Playlist
YOUTUBE_DELETE_PLAYLISTDelete a YouTube playlist owned by the authenticated user or channel after explicit confirmation. The result reports whether deletion succeeded; certain API errors are returned as structured failure results.Input Parameters
true to proceed with deletion. This is a safety measure to prevent accidental playlist deletions.Output
Delete Playlist Item
Delete Playlist Item
YOUTUBE_DELETE_PLAYLIST_ITEMTool to delete a playlist item (remove a video from a playlist). Use when removing specific videos from playlists.Input Parameters
Output
Delete Video
Delete Video
YOUTUBE_DELETE_VIDEOTool to delete a YouTube video owned by the authenticated user/channel. Use when you need to permanently remove a video from YouTube. Requires explicit confirmation via confirmDelete: true to prevent accidental deletions. The video must exist and be owned by the authenticated channel.Input Parameters
true to proceed with deletion. This is a safety measure to prevent accidental video deletions.Output
Get Channel Activities
Get Channel Activities
YOUTUBE_GET_CHANNEL_ACTIVITIESGets recent activities from a YouTube channel including video uploads, playlist additions, likes, and other channel events.Input Parameters
Output
Get channel ID by handle
Get channel ID by handle
YOUTUBE_GET_CHANNEL_ID_BY_HANDLERetrieves the YouTube Channel ID for a specific YouTube channel handle.Input Parameters
Output
Get Channel Statistics
Get Channel Statistics
YOUTUBE_GET_CHANNEL_STATISTICSGets detailed statistics for YouTube channels including subscriber counts, view counts, and video counts. Channels can be identified using their ID, handle (e.g., @Google), or username.Input Parameters
Output
Get Playlists by ID
Get Playlists by ID
YOUTUBE_GET_PLAYLISTS_BY_IDRetrieves one or more playlists by their YouTube playlist IDs.Input Parameters
Output
Video Details Batch
Video Details Batch
YOUTUBE_GET_VIDEO_DETAILS_BATCHRetrieves multiple YouTube video resource parts in a single batch call. Use when you need cohort-level metrics for many videos to reduce quota usage and latency.Input Parameters
Output
Get Video Rating
Get Video Rating
YOUTUBE_GET_VIDEO_RATINGRetrieves the ratings that the authorized user gave to a list of specified videos. Use when you need to check if a user has liked or disliked specific videos.Input Parameters
Output
List captions
List captions
YOUTUBE_LIST_CAPTION_TRACKRetrieves a list of caption tracks for a YouTube video. Returns an empty items list if no captions are available. Raises ExecutionFailed if the video ID is invalid or not found.Input Parameters
Output
List Channels
List Channels
YOUTUBE_LIST_CHANNELSLists YouTube channels by ID, handle, username, or ownership status, returning channel metadata, statistics, and content details. If multiple filters are supplied, only the first in ID, handle, username, owned, then managed order is used.Input Parameters
Output
List Channel Sections
List Channel Sections
YOUTUBE_LIST_CHANNEL_SECTIONSTool to retrieve channel sections from YouTube. Use when you need to get the layout sections of a channel’s homepage. Channel sections organize content into categories like playlists, uploads, or featured channels.Input Parameters
Output
List channel videos
List channel videos
YOUTUBE_LIST_CHANNEL_VIDEOSLists videos from a YouTube channel identified by channel ID, handle, supported channel URL, or the authenticated user’s channel. Results are paginated, with 1–50 videos per page. An empty result can mean the channel ID was not found or that no uploads playlist was available.Input Parameters
nextPageToken from a previous response for the next page, or prevPageToken for the previous page. Page tokens are opaque, ephemeral values that must come directly from a previous LIST_CHANNEL_VIDEOS response and cannot be constructed or reused across different queries.Output
List Comments
List Comments
YOUTUBE_LIST_COMMENTSList individual YouTube comments by comment ID or replies to a top-level comment by parent ID. Results are paginated when listing replies and may include author, text, timestamps, and engagement details.Input Parameters
Output
List Comment Threads (Deprecated)
List Comment Threads (Deprecated)
YOUTUBE_LIST_COMMENT_THREADSDEPRECATED: Use YOUTUBE_LIST_COMMENT_THREADS2 instead. List comment threads from YouTube videos or channels for qualitative analysis and reporting. Returns top-level comments with optional replies (up to 5 per thread). Use the ‘videoId’ parameter to retrieve comments on a specific video (most common use case).Input Parameters
Output
List Comment Threads
List Comment Threads
YOUTUBE_LIST_COMMENT_THREADS2Tool to retrieve comment threads from YouTube videos or channels matching API request parameters. Use when you need to fetch comments with filtering by video, channel, or specific thread IDs.Input Parameters
Output
List I18n Languages
List I18n Languages
YOUTUBE_LIST_I18N_LANGUAGESReturns a list of application languages that the YouTube website supports. Use this when you need to retrieve all available language options for YouTube’s interface or to localize content.Input Parameters
Output
List I18n Regions
List I18n Regions
YOUTUBE_LIST_I18N_REGIONSTool to retrieve a list of content regions that the YouTube website supports. Returns region codes (ISO 3166-1 alpha-2) and localized region names. Use when you need to identify available geographic regions for content filtering or display.Input Parameters
Output
List Live Broadcasts
List Live Broadcasts
YOUTUBE_LIST_LIVE_BROADCASTSList the connected channel’s live broadcasts by lifecycle status, ID, or ownership.Input Parameters
Output
List Live Chat Messages
List Live Chat Messages
YOUTUBE_LIST_LIVE_CHAT_MESSAGESTool to list live chat messages for a specific chat. Use for monitoring live chat during broadcasts or retrieving chat history. Returns messages with author details, timestamps, and message types (text, Super Chat, moderation events).Input Parameters
Output
List Live Streams
List Live Streams
YOUTUBE_LIST_LIVE_STREAMSLists live streams owned by the connected channel or selected by stream ID.Input Parameters
Output
List Most Popular Videos
List Most Popular Videos
YOUTUBE_LIST_MOST_POPULAR_VIDEOSTool to list the current most-popular (charts/trending) YouTube videos for a region and/or category via videos.list(chart=mostPopular). Use when you need to retrieve YouTube’s official trending or most popular videos, not keyword-search approximations.Input Parameters
Output
List Playlist Images
List Playlist Images
YOUTUBE_LIST_PLAYLIST_IMAGESRetrieves playlist images by playlist ID or playlist image IDs, including custom playlist thumbnails.Input Parameters
Output
List Playlist Items
List Playlist Items
YOUTUBE_LIST_PLAYLIST_ITEMSTool to list videos in a playlist, with pagination support. Use when walking through a channel’s uploads playlist to enumerate all videos.Input Parameters
Output
List Rated Videos
List Rated Videos
YOUTUBE_LIST_RATED_VIDEOSList up to the 1,000 most recent videos liked or disliked by the authenticated YouTube user.Input Parameters
Output
List Super Chat Events
List Super Chat Events
YOUTUBE_LIST_SUPER_CHAT_EVENTSLists Super Chat events for a channel, showing supporter purchases during live streams. Returns Super Chat and Super Sticker events from the past 30 days. Use to track and acknowledge supporter contributions.Input Parameters
Output
List user playlists
List user playlists
List user subscriptions
List user subscriptions
YOUTUBE_LIST_USER_SUBSCRIPTIONSRetrieves the authenticated user’s YouTube channel subscriptions, allowing specification of response parts and pagination.Input Parameters
id, snippet, contentDetails, and subscriberSnippet.Output
List Video Abuse Report Reasons
List Video Abuse Report Reasons
YOUTUBE_LIST_VIDEO_ABUSE_REPORT_REASONSTool to retrieve a list of abuse report reasons that can be used to report abusive videos on YouTube. Use when you need to display available reporting categories or before calling videos.reportAbuse. Returns localized reason labels and optional secondary categorizations.Input Parameters
Output
List Video Categories
List Video Categories
YOUTUBE_LIST_VIDEO_CATEGORIESTool to list YouTube video categories that can be associated with videos. Use when you need to retrieve available video categories for a specific region or get details about specific category IDs.Input Parameters
Output
Download YouTube caption track
Download YouTube caption track
YOUTUBE_LOAD_CAPTIONSDownloads a specific YouTube caption track, which must be owned by the authenticated user, and returns its content as text. Note: This action requires you to own the video (YouTube Data API v3 restriction). Non-owned videos will return 403 Forbidden errors, including many auto-generated caption tracks.Input Parameters
Output
Mark Comment as Spam
Mark Comment as Spam
YOUTUBE_MARK_COMMENT_AS_SPAMTool to mark one or more YouTube comments as spam. Use when moderating comments to flag spam content. Note: This endpoint is deprecated but still functional according to YouTube API documentation.Input Parameters
Output
Multipart upload video
Multipart upload video
YOUTUBE_MULTIPART_UPLOAD_VIDEOUploads a video to YouTube using multipart upload in a single request. Use when you want to upload both metadata and video file together. This action uploads the video file and metadata in one request, unlike resumable upload which requires two steps.Input Parameters
Output
Post Comment on Video
Post Comment on Video
YOUTUBE_POST_COMMENTTool to post a new top-level comment on a YouTube video. Use when creating comments to engage with video content or respond to user requests.Input Parameters
Output
Query YouTube Analytics
Query YouTube Analytics
YOUTUBE_QUERY_ANALYTICSQuery a channel or content owner’s YouTube Analytics result table.Input Parameters
Output
Rate Video
Rate Video
YOUTUBE_RATE_VIDEOTool to add a like or dislike rating to a YouTube video, or remove an existing rating. Use when you need to rate videos on behalf of the authenticated user.Input Parameters
Output
Report Video for Abuse
Report Video for Abuse
YOUTUBE_REPORT_VIDEO_ABUSETool to report a YouTube video for containing abusive content. Use when you need to flag videos that violate YouTube’s community guidelines or contain harmful content.Input Parameters
Output
Search YouTube
Search YouTube
YOUTUBE_SEARCH_YOU_TUBESearches YouTube for videos, channels, or playlists using a query term, returning structured search results.Input Parameters
Output
Set Comment Moderation Status
Set Comment Moderation Status
YOUTUBE_SET_COMMENT_MODERATION_STATUSTool to set the moderation status of one or more YouTube comments. Use when moderating comments to hold for review, publish, or reject them. Optionally ban the comment author when rejecting.Input Parameters
Output
Subscribe to channel
Subscribe to channel
YOUTUBE_SUBSCRIBE_CHANNELSubscribes the authenticated user to a YouTube channel by channel ID. An existing subscription is treated as success, but its actual subscription details may not be available in the result.Input Parameters
Output
Unsubscribe from channel
Unsubscribe from channel
YOUTUBE_UNSUBSCRIBE_CHANNELTool to unsubscribe the authenticated user from a YouTube channel by deleting a subscription. Use when you need to remove an existing subscription. The subscription ID can be obtained from the YOUTUBE_LIST_USER_SUBSCRIPTIONS tool.Input Parameters
YOUTUBE_LIST_USER_SUBSCRIPTIONS tool. The subscription must belong to the authenticated user.Output
Update caption track
Update caption track
YOUTUBE_UPDATE_CAPTIONUpdates a YouTube caption track’s metadata such as name, language, or draft status. Use this to modify existing caption track properties without uploading new caption content. Note: Only properties specified in the snippet will be updated; unspecified properties retain their current values.Input Parameters
Output
Update channel
Update channel
YOUTUBE_UPDATE_CHANNELUpdates a channel’s metadata including branding settings and localizations. Only brandingSettings, invideoPromotion, and localizations properties can be updated. Requires the channel to be owned by the authenticated user.Input Parameters
Output
Update Channel Section
Update Channel Section
Update Comment
Update Comment
Update Playlist
Update Playlist
YOUTUBE_UPDATE_PLAYLISTTool to modify an existing YouTube playlist’s metadata (title, description, privacy status). Use when updating playlist information for the authenticated user’s channel.Input Parameters
Output
Update Playlist Item
Update Playlist Item
YOUTUBE_UPDATE_PLAYLIST_ITEMTool to modify a playlist item’s properties such as position or note. Use when reordering videos in a playlist or updating item metadata.Input Parameters
Output
Update thumbnail
Update thumbnail
YOUTUBE_UPDATE_THUMBNAILSets the custom thumbnail for a YouTube video using an image from a URL. Requirements: - The authenticated user must own the video or have permission to edit it - The YouTube channel must be verified (phone verification required) to upload custom thumbnails - Image must be JPG, PNG, or GIF; under 2MB; recommended 1280x720 resolution (16:9 aspect ratio)Input Parameters
Output
Update video
Update video
YOUTUBE_UPDATE_VIDEOUpdates metadata for a YouTube video identified by videoId, which must exist; an empty list for tags removes all existing tags.Input Parameters
None. YouTube restrictions: (1) Angle brackets < > are forbidden and will be removed automatically. (2) Total characters across all tags must not exceed 500 (spaces in tags add 2 extra characters due to internal quoting, and commas between tags count toward the limit).None.None. Numeric values will be converted to strings.None.Output
Upload caption media
Upload caption media
YOUTUBE_UPLOAD_CAPTION_MEDIAReplaces the media bytes of an existing YouTube caption track.Input Parameters
Output
Upload caption track
Upload caption track
YOUTUBE_UPLOAD_CAPTION_TRACKCreates a caption track for an owned video and uploads its caption media.Input Parameters
Output
Upload video
Upload video
Triggers
New YouTube Activity
New YouTube Activity
New Item in YouTube Playlist
New Item in YouTube Playlist