YouTube
YouTube is Google's video platform, and this connector reaches the creator side of it — videos, playlists, comments, subscriptions, live streaming, channel memberships and analytics.
Authentication
- OAuth 2.0
Actions
Generic API request. Call any YouTube API endpoint on this connection, for the case where no shipped action covers it yet. The connection supplies the base URL, the authentication and the egress route, so only the path, query and body are yours to fill.
- Add analytics group itemAdd one video, playlist, channel or asset to an existing YouTube Analytics group so queryanalyticsreport can aggregate it under group==GROUPID.
- Add live chat moderatorDestructiveGrant a channel moderator rights on one live chat, letting it delete messages and ban viewers there.
- Add video to playlistAdd one video to a playlist owned by the connected account.
- Ban viewer from live chatDestructiveBan or time out a viewer in one live chat.
- Batch get video statsDestructiveFetch view, like and comment counts for up to 50 videos in one call.
- Bind broadcast to streamAttach an ingestion stream to a broadcast, or detach the current one.
- Close live chat pollDestructiveClose a durable chat event — in practice, end a running chat poll so its result is final and no further votes are counted.
- Create analytics groupCreate an empty YouTube Analytics group, then fill it with createanalyticsgroupitem.
- Create channel sectionAdd a shelf to the home page of the channel the connection is signed in as — a featured playlist, a set of playlists, a list of other channels, or one of YouTube's computed shelves such as popularUploads.
- Create comment threadPost a new top-level comment, as the channel the connection is signed in as — on a video (Video id) or on a channel's discussion page (Channel id); set exactly one of the two.
- Create live broadcastSchedule a new live broadcast on the connected channel.
- Create live streamCreate an ingestion stream — the endpoint an encoder pushes video to.
- Create playlistCreate a new, empty playlist on the channel the connection is signed in as, then add videos to it with youtube:addplaylistitem.
- Create reporting jobStart a YouTube Reporting job so YouTube begins generating a daily CSV for one report type.
- Create third-party linkRegister a shopping or affiliate-program link between the channel and a merchant.
- Delete analytics groupDestructiveDelete a YouTube Analytics group and, with it, every membership inside it.
- Delete caption trackDestructiveDelete a caption track from a video.
- Delete channel sectionDestructiveRemove a shelf from the channel's home page.
- Delete commentDestructivePermanently delete a comment.
- Delete live broadcastDestructiveDelete a live broadcast and its watch page.
- Delete live chat messageDestructiveRemove one message from a live chat — the moderation action behind "delete" in the YouTube chat UI.
- Delete live streamDestructiveDelete an ingestion stream and invalidate its stream key, so any encoder configured with that key stops being able to connect.
- Delete playlistDestructivePermanently delete a playlist owned by the connected account.
- Delete playlist imageDestructiveRemove a custom cover image from a playlist, so the playlist falls back to the auto-generated thumbnail.
- Delete reporting jobDestructiveStop a YouTube Reporting job and drop the reports it produced.
- Delete third-party linkDestructiveRemove a shopping or affiliate-program link from the channel, ending the connection to that merchant.
- Delete videoDestructivePermanently delete one video the connected account owns.
- Get my video ratingsRead back the rating the connected account has given each of up to 50 videos — the counterpart to youtube:ratevideo, and the way to make a like idempotent by checking before you write.
- Get reporting jobRead one YouTube Reporting job's metadata — its report type, name, creation time and expiry — without listing every job.
- Get reporting job reportRead one generated report's metadata — the period it covers, when it was produced and the downloadUrl of its gzipped CSV.
- Get video trainabilityRead whether a video may be used to train third-party AI models, as the channel has declared it in YouTube's third-party training settings.
- Insert broadcast cuepointTrigger an ad break in a broadcast that is currently live.
- Lift live chat banDestructiveLift a ban so the viewer can post in the chat again.
- List abuse report reasonsList the reason codes YouTube accepts when flagging a video, so you can pick a valid reasonId (and optional secondaryReasonId) for youtube:reportvideoabuse.
- List analytics group itemsList what is inside one YouTube Analytics group.
- List analytics groupsList the YouTube Analytics groups the connected account owns.
- List captionsList the caption tracks on one video — uploaded subtitles as well as YouTube's automatic ones.
- List channel activitiesRead a channel's activity feed — the events it published, newest first.
- List channel membersRead the paying channel members (formerly sponsors) of the connected creator's channel.
- List channel sectionsRead the shelves that make up a channel's home page — "Uploads", "Popular videos", a featured playlist, and so on — in the order they are displayed.
- List channelsRead YouTube channel resources — the connected account's own channel (mine = true), specific channels by id, or a channel looked up by @handle or legacy username.
- List comment repliesPage through the replies to one comment thread, or fetch specific comments by id.
- List comment threadsRead top-level comments and, optionally, the replies bundled with them.
- List content regionsList the content regions YouTube supports — the ISO 3166-1 alpha-2 codes accepted wherever a regionCode is asked for, such as region-scoped chart and category lookups.
- List interface languagesList the application languages YouTube's own interface supports.
- List live broadcastsList the connected channel's live broadcasts — upcoming, currently live, or finished.
- List live chat messagesRead messages from a live chat.
- List live chat moderatorsList the channels moderating one live chat.
- List live streamsList the connected channel's ingestion streams — the encoder-facing half of a live event, separate from the broadcasts that display them.
- List membership levelsRead the channel-membership tiers the connected creator offers to their fans, cheapest first.
- List playlist imagesRead the custom cover images uploaded for a playlist.
- List playlist itemsRead the videos inside a playlist, in playlist order.
- List playlistsFind playlists on YouTube — the ones the connected account owns (Mine), the ones a given channel owns (Channel id), or specific playlists by id.
- List reporting job reportsList the report instances a YouTube Reporting job has generated — one per covered day, each with the period it spans and a downloadUrl for its gzipped CSV.
- List reporting jobsList the YouTube Reporting jobs on the channel or content owner.
- List reporting report typesList the bulk report types available to this channel or content owner — the catalogue you pick from before creating a reporting job.
- List subscriptionsRead subscriptions in either direction — who the account follows, or who follows it.
- List Super Chat eventsList the Super Chat and Super Sticker purchases made on the connected channel — who paid, how much, in which currency, and the message attached.
- List third-party linksList the shopping and affiliate-program links attached to a channel — the connections behind YouTube Shopping between a channel and a merchant store.
- List video categoriesList the video categories YouTube offers in a country, so you can pick the numeric categoryId that videos.snippet.categoryId takes.
- List videosRead full video resources — metadata, statistics, status and processing details — for videos you already have ids for, for the most-popular chart in a country, or for the videos the connected account has rated.
- Mark comments as spamDestructiveReport one or more comments to YouTube as spam, in the connected account's opinion.
- Query analytics reportRun a YouTube Analytics report over a date range — views, watch time, subscribers gained/lost, traffic sources, geography, demographics, playlist behaviour and (for a monetised channel) revenue.
- Rate videoDestructiveSet the connected account's rating on a video — like, dislike, or none to withdraw a rating it previously gave.
- Remove analytics group itemDestructiveRemove one membership from a YouTube Analytics group.
- Remove channel watermarkDestructiveRemove the branding watermark that overlays a channel's videos.
- Remove live chat moderatorDestructiveRevoke a channel's moderator rights on one live chat.
- Remove video from playlistDestructiveRemove one entry from a playlist.
- Rename analytics groupDestructiveRename an existing YouTube Analytics group.
- Reply to a commentReply to an existing comment thread, as the channel the connection is signed in as.
- Report abuseFile an abuse report against a video, channel, playlist or comment — the API equivalent of the Report button.
- Report video abuseDestructiveFlag a video to YouTube for review, as the connected account — the API equivalent of the Report button, filed against the account's own standing.
- Search YouTubeSearch YouTube for videos, channels and playlists matching a query and filters, or list a single channel's uploads by combining channelId with order=date.
- Send live chat messagePost a text message into a live chat as the connected account.
- Set comment moderation statusDestructiveApprove, hold or reject one or more comments on a video or channel the connected account owns.
- Set video thumbnailDestructiveUpload a custom thumbnail image for a video the connected account owns, replacing whichever thumbnail is currently set.
- Subscribe to a channelSubscribe the connected account to another channel.
- Transition live broadcastDestructiveMove a broadcast through its lifecycle: testing (preview only), live (public) or complete (ended).
- Unsubscribe from a channelDestructiveUnsubscribe the connected account from a channel.
- Update caption draft statusDestructivePublish or unpublish an existing caption track by flipping its draft flag — a draft track exists on the video but is hidden from viewers.
- Update channelDestructiveChange a channel's branding settings — the about-page description, search keywords, country, channel-page trailer — or its translated titles and descriptions.
- Update channel sectionDestructiveChange an existing shelf on the channel's home page — retitle it, move it, swap the playlists it shows, or narrow who sees it.
- Update commentDestructiveEdit the text of a comment the connected account itself wrote.
- Update live broadcastDestructiveChange an existing broadcast's title, schedule, privacy or streaming options.
- Update live streamDestructiveChange an ingestion stream's title, description or CDN settings.
- Update playlistDestructiveChange the title, description, tags or privacy of an existing playlist.
- Update playlist itemDestructiveReorder a video inside a playlist, or change its curator note.
- Update third-party linkDestructiveChange the merchant details of an existing shopping or affiliate-program link.
- Update videoDestructiveChange the metadata of a video the connected account owns — title, description, tags, category, privacy, scheduled publish time, recording date and translations.
Triggers
- New commentStarts when someone leaves a new top-level comment on the watched YouTube video or channel.
- New live broadcastStarts when a live broadcast is created on the connected YouTube channel, one run per broadcast.
- New subscriberStarts when a channel subscribes to the connected YouTube channel.
- New videoStarts when a video is published on the watched YouTube channel, one run per upload.
Product names, logos and brands are the property of their respective owners and are used here for identification only. Their use does not imply endorsement by, or affiliation with, those owners.