YouTube for AI agents
Agents read YouTube at once. Changes and sends are held for a person's approval by default.
About YouTube
YouTube is a video-sharing platform with user-generated content, live streaming, and monetization opportunities, widely used for marketing, education, and entertainment
What an agent can do in YouTube
Every YouTube action is classed by the platform as a read, a change or a send. Reads run at once. Changes and sends are held for a person by default.
Runs at once (reads)
Looks things up in YouTube without asking first. 29 actions.
- List captionsRetrieves 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.
- List ChannelsLists YouTube channels by ID, handle, username, or ownership status, returning detailed channel information including metadata, statistics, and content details. Use this action when you need to retrie
- List CommentsList individual comments from YouTube videos. Returns comment details including author, text, timestamps, and engagement metrics. Use 'id' parameter to retrieve specific comments or 'parentId' to retr
- Get Channel ActivitiesGets recent activities from a YouTube channel including video uploads, playlist additions, likes, and other channel events.
- Get channel ID by handleRetrieves the YouTube Channel ID for a specific YouTube channel handle.
- 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.
- Get Playlists by IDRetrieves one or more playlists by their YouTube playlist IDs.
- 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.
- 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.
- 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 feat
- List channel videosLists videos from a specified YouTube channel. This action primarily uses the playlistItems.list endpoint with the channel's uploads playlist, which is the recommended approach by YouTube. The uploads
- List Comment ThreadsTool 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.
Show all 29
- 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.
- 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 r
- List Live BroadcastsList the connected channel's live broadcasts by lifecycle status, ID, or ownership.
- 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 (tex
- List Live StreamsLists live streams owned by the connected channel or selected by stream ID.
- 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 mos
- List Playlist ImagesTool to retrieve playlist images associated with a specific playlist. Use when fetching custom thumbnail images for playlists.
- 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.
- List Rated VideosList up to the 1,000 most recent videos liked or disliked by the authenticated YouTube user.
- 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 contri
- List user playlistsRetrieves playlists owned by the authenticated user, implicitly using mine=True.
- List user subscriptionsRetrieves the authenticated user's YouTube channel subscriptions, allowing specification of response parts and pagination.
- 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.
- 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.
- Download YouTube caption trackDownloads 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 restric
- Query YouTube AnalyticsQuery a channel or content owner's YouTube Analytics result table.
- Search YouTubeSearches YouTube for videos, channels, or playlists using a query term, returning the raw API response.
Held for approval by default (changes and sends)
Held for a person's approval by default. The approval is recorded and the action is sent once, never twice, with 10 seconds to undo. 25 actions.
- 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.
- Insert Comment ReplyTool to create a reply to an existing YouTube comment. Use when responding to user comments or engaging in conversations on videos.
- Create PlaylistTool to create a new YouTube playlist on the authenticated user's channel. Use when organizing videos into collections or building curated playlists.
- Post Comment on VideoTool 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.
- 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.
- Update CommentTool to modify the text of an existing YouTube comment. Use when updating or correcting a previously posted comment.
- 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.
- 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
- Insert 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.
- Delete caption trackPermanently deletes an owned caption track after explicit confirmation with `confirmDelete: true`.
- Delete Channel SectionTool to delete a YouTube channel section. Use when you need to remove a channel section from a channel. The channel section must exist and the authenticated user must have permission to delete it.
- Delete CommentTool to delete a YouTube comment owned by the authenticated user or channel. Use when you need to remove a comment from a video. The comment must exist and be owned by the authenticated channel.
Show all 25
- Delete Live BroadcastPermanently delete an owned YouTube live broadcast after confirmation.
- Delete PlaylistTool to delete a YouTube playlist owned by the authenticated user/channel. Use when you need to permanently remove a playlist from YouTube. Requires explicit confirmation via `confirmDelete: true` to
- Delete Playlist ItemTool to delete a playlist item (remove a video from a playlist). Use when removing specific videos from playlists.
- 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 preven
- 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.
- Report Video for 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.
- Subscribe to channelSubscribes the authenticated user to a specified YouTube channel, identified by its unique `channelId` which must be valid and existing.
- Unsubscribe from 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 `YOUTUB
- Update caption trackUpdates 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 sp
- 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 th
- Update Channel SectionTool to update an existing YouTube channel section by ID. Use when modifying section properties like title, position, or featured content.
- 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.
- Update videoUpdates metadata for a YouTube video identified by videoId, which must exist; an empty list for tags removes all existing tags.
Changes wait in Needs you
Changes and sends in YouTube are held for a person's approval by default. The approval is recorded, and the action is sent once, never twice, with 10 seconds to undo.
Related connectors
YouTube questions
Can an agent change data in YouTube on its own?
Not by default. Changes and sends in YouTube are held for a person's approval. The approval is recorded, and the action is sent once, never twice, with 10 seconds to undo.
What can an agent read in YouTube?
This connector lists 29 read actions. Reads run at once, without waiting for approval.
How does YouTube connect?
It connects with OAuth 2.0. Connectors are built and maintained by third-party developers; availability is confirmed during scoping.