> ## Documentation Index > Fetch the complete documentation index at: https://docs.boxd.sh/llms.txt > Use this file to discover all available pages before exploring further. # YouTube > YouTube is a video-sharing platform with user-generated content, live streaming, and monetization opportunities, widely used for marketing, education, and entertainment YouTube is a video-sharing platform with user-generated content, live streaming, and monetization opportunities, widely used for marketing, education, and entertainment `youtube` · **51 tools** · **4 triggers** ## Connect it ```bash theme={"theme":"github-dark"} run auth youtube run auth youtube --scope team # shared with the organization ``` Or from the [Integrations page](https://app.boxd.sh/integrations) in the console. See [Connections](/guides/integrations/connections) for personal versus shared, and who may remove one. ## Use it ```bash theme={"theme":"github-dark"} run youtube # common commands run youtube --all # every command ``` ```ts theme={"theme":"github-dark"} import { youtube } from "@boxd/run"; ``` ## Common tools | Tool | What it does | | ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `add-video-to-playlist` | Tool to add a video to a playlist by inserting a playlist item. | | `create-comment-reply` | Tool to create a reply to an existing YouTube comment. Use when responding to user comments or engaging in conversations on videos. | | `create-playlist` | Tool to create a new YouTube playlist on the authenticated user's channel. | | `list-caption-track` | Retrieves a list of caption tracks for a YouTube video. Returns an empty items list if no captions are available. | | `list-channels` | Lists YouTube channels by ID, handle, username, or ownership status, returning detailed channel information including metadata, statistics, and content details. | | `list-comments` | List individual comments from YouTube videos. Returns comment details including author, text, timestamps, and engagement metrics. | | `list-comment-threads` | DEPRECATED: Use YOUTUBE\_LIST\_COMMENT\_THREADS2 instead. List comment threads from YouTube videos or channels for qualitative analysis and reporting. | | `multipart-upload-video` | Uploads a video to YouTube using multipart upload in a single request. | | `post-comment` | Tool 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-status` | Tool to set the moderation status of one or more YouTube comments. | | `update-comment` | Tool to modify the text of an existing YouTube comment. Use when updating or correcting a previously posted comment. | | `update-playlist` | Tool to modify an existing YouTube playlist's metadata (title, description, privacy status). | | `update-thumbnail` | Sets the custom thumbnail for a YouTube video using an image from a URL. | | `upload-video` | Uploads a video file to a YouTube channel; the video file must be in a YouTube-supported format. | | Tool | What it does | | --------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `add-video-to-playlist` | Tool to add a video to a playlist by inserting a playlist item. | | `create-channel-section` | Tool to create a new channel section for the authenticated user's YouTube channel. | | `create-comment-reply` | Tool to create a reply to an existing YouTube comment. Use when responding to user comments or engaging in conversations on videos. | | `create-playlist` | Tool to create a new YouTube playlist on the authenticated user's channel. | | `delete-channel-section` | Tool to delete a YouTube channel section. Use when you need to remove a channel section from a channel. | | `delete-comment` | Tool to delete a YouTube comment owned by the authenticated user or channel. | | `delete-playlist` | Tool to delete a YouTube playlist owned by the authenticated user/channel. | | `delete-playlist-item` | Tool to delete a playlist item (remove a video from a playlist). | | `delete-video` | Tool to delete a YouTube video owned by the authenticated user/channel. | | `get-channel-activities` | Gets recent activities from a YouTube channel including video uploads, playlist additions, likes, and other channel events. | | `get-channel-id-by-handle` | Retrieves the YouTube Channel ID for a specific YouTube channel handle. | | `get-channel-statistics` | Gets detailed statistics for YouTube channels including subscriber counts, view counts, and video counts. | | `get-video-details-batch` | Retrieves multiple YouTube video resource parts in a single batch call. | | `get-video-rating` | Retrieves the ratings that the authorized user gave to a list of specified videos. | | `list-caption-track` | Retrieves a list of caption tracks for a YouTube video. Returns an empty items list if no captions are available. | | `list-channels` | Lists YouTube channels by ID, handle, username, or ownership status, returning detailed channel information including metadata, statistics, and content details. | | `list-channel-sections` | Tool to retrieve channel sections from YouTube. Use when you need to get the layout sections of a channel's homepage. | | `list-channel-videos` | Lists videos from a specified YouTube channel. This action primarily uses the playlistItems.list endpoint with the channel's uploads playlist, which... | | `list-comments` | List individual comments from YouTube videos. Returns comment details including author, text, timestamps, and engagement metrics. | | `list-comment-threads` | DEPRECATED: Use YOUTUBE\_LIST\_COMMENT\_THREADS2 instead. List comment threads from YouTube videos or channels for qualitative analysis and reporting. | | `list-comment-threads2` | Tool to retrieve comment threads from YouTube videos or channels matching API request parameters. | | `list-i18n-languages` | Returns a list of application languages that the YouTube website supports. | | `list-i18n-regions` | Tool to retrieve a list of content regions that the YouTube website supports. | | `list-live-chat-messages` | Tool to list live chat messages for a specific chat. Use for monitoring live chat during broadcasts or retrieving chat history. | | `list-most-popular-videos` | DEPRECATED: Use YOUTUBE\_UPDATE\_VIDEO instead. Tool to list the current most-popular (charts/trending) YouTube videos for a region and/or category via... | | `list-playlist-images` | Tool to retrieve playlist images associated with a specific playlist. | | `list-playlist-items` | Tool to list videos in a playlist, with pagination support. Use when walking through a channel's uploads playlist to enumerate all videos. | | `list-super-chat-events` | Lists Super Chat events for a channel, showing supporter purchases during live streams. | | `list-user-playlists` | Retrieves playlists owned by the authenticated user, implicitly using mine=True. | | `list-user-subscriptions` | Retrieves the authenticated user's YouTube channel subscriptions, allowing specification of response parts and pagination. | | `list-video-abuse-report-reasons` | Tool to retrieve a list of abuse report reasons that can be used to report abusive videos on YouTube. | | `list-video-categories` | Tool to list YouTube video categories that can be associated with videos. | | `load-captions` | Downloads a specific YouTube caption track, which must be owned by the authenticated user, and returns its content as text. | | `mark-comment-as-spam` | Tool to mark one or more YouTube comments as spam. Use when moderating comments to flag spam content. | | `multipart-upload-video` | Uploads a video to YouTube using multipart upload in a single request. | | `post-comment` | Tool 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. | | `rate-video` | Tool to add a like or dislike rating to a YouTube video, or remove an existing rating. | | `report-video-abuse` | Tool to report a YouTube video for containing abusive content. | | `search-you-tube` | Searches YouTube for videos, channels, or playlists using a query term, returning the raw API response. | | `set-comment-moderation-status` | Tool to set the moderation status of one or more YouTube comments. | | `subscribe-channel` | Subscribes the authenticated user to a specified YouTube channel, identified by its unique `channelId` which must be valid and existing. | | `unsubscribe-channel` | Tool to unsubscribe the authenticated user from a YouTube channel by deleting a subscription. | | `update-caption` | Updates a YouTube caption track's metadata such as name, language, or draft status. | | `update-channel` | Updates a channel's metadata including branding settings and localizations. | | `update-channel-section` | Tool to update an existing YouTube channel section by ID. Use when modifying section properties like title, position, or featured content. | | `update-comment` | Tool to modify the text of an existing YouTube comment. Use when updating or correcting a previously posted comment. | | `update-playlist` | Tool to modify an existing YouTube playlist's metadata (title, description, privacy status). | | `update-playlist-item` | Tool to modify a playlist item's properties such as position or note. | | `update-thumbnail` | Sets the custom thumbnail for a YouTube video using an image from a URL. | | `update-video` | Updates metadata for a YouTube video identified by videoId, which must exist; an empty list for tags removes all existing tags. | | `upload-video` | Uploads a video file to a YouTube channel; the video file must be in a YouTube-supported format. | ## Triggers (4) Subscribe with `.on(...)` in a script. A trigger with required configuration takes it as the second argument. | Trigger | Needs | What fires it | | -------------------------------- | ------------- | -------------------------------------------------------------- | | New YouTube Activity | `channel_id` | Triggers when a new activity is detected on a YouTube channel. | | New Item in YouTube Playlist | `playlist_id` | Triggers when a new item is added to a YouTube playlist. | | New Playlist in YouTube Channel | `channel_id` | Triggers when a new playlist is added to a YouTube channel. | | New YouTube Channel Subscription | nothing | Triggers when a new channel is subscribed. | [Open YouTube in the console →](https://app.boxd.sh/integrations/detail/youtube)