YouTube
YouTube · 196 endpoints
- 评论评论. Returns list, default 20, max 100 per call
- 主页或对象详情主页或对象详情. Returns single object
- 粉丝数量粉丝数量. Returns single object
- 用户内容用户内容. Returns list, default 10, max 50 per call
- 关键词搜索关键词搜索. Returns list, default 10, max 50 per call
- Shorts 短视频Shorts 短视频. Returns list, default 20, max 100 per call
- 视频文稿视频文稿. Returns single object
- 视频详情视频详情. Returns single object
Channel community posts
- YouTube channel community posts by channel idYoutube: get channel community posts (web_v2)
- YouTube channel community posts by id or usernameFetches community posts from a YouTube channel's Posts tab, including post ID, URL, content, images, attached video, like count, publish time, channel info, and a continuationToken when YouTube has more results.
Channel profile
- YouTube channel profile by URLYouTube - Channels
- One YouTube channel's factsOne YouTube channel as one row, from its about page: channel id, handle, title, description, subscribers (YouTube's rounded count as a number, and its shown text), video and view counts, joined date, country, links with their real targets, avatar, banner and the verified badge. `channel` is a channel URL (/@handle, /channel/UC…, /c/name, /user/name), a @handle or a UC… id. One plain request, about 1 second. An unknown channel gives no row. Columns: channel_id, handle, title, description, subscribers, subscribers_text, videos, views, joined, country, links, avatar, banner, verified, url.
- YouTube channel profile by id or username — subscribersRetrieves comprehensive YouTube channel profile data including name, avatar images, subscriber count, total video and view counts, join date, tags, and linked social accounts.
- YouTube channel profile by channel idYoutube: get channel info (web)
- YouTube channel description by channel idYoutube: get channel description (web_v2)
- Your YouTube channel profile — subscribers, viewsGet your YouTube channel's profile and lifetime stats (subscribers, views, video count)
- youtube.channel.profile — routed: best of 4 providers, own keys firstA YouTube channel's public profile by channel id — treg picks the provider and names the one that served
- youtube.channel.profile — routed: best of 4 providers, own keys firstA YouTube channel's public profile by channel id — treg picks the provider and names the one that served
Channel Shorts
- YouTube channel Shorts by channel idYoutube: get channel short videos (web)
- YouTube channel Shorts by channel id or URLYoutube: get channel shorts (web_v2)
- YouTube channel Shorts by id or username — views, likesRetrieves a paginated list of short-form videos (Shorts) from a YouTube channel, including each short's title, URL, view count (views), likes, comments, and description.
Channel videos
- A YouTube channel's latest videosThe latest videos of a YouTube channel, newest first: title, link, video id, when it was published, views and the thumbnail. `channel` is a channel id (UC…), a handle (@name or name) or a channel URL; `limit` caps the rows (at most 30). A run takes about a second, from YouTube's own channel list. Columns: title, url, video_id, published, views, description, thumbnail.
- YouTube channel videos by channel idRetrieve public videos from a YouTube channel, with optional cursor-based pagination.
- YouTube channel videos by channel idVideos of a YouTube channel by channel id
- List your YouTube videos, private and unlisted includedList your own channel's videos, newest first (includes private and unlisted ones)
- List a channel's videos via its uploads playlist idList a channel's uploaded videos cheaply, via its uploads playlist
- youtube.channel.videos — routed: best of 2 providers, own keys firstA YouTube channel's recent videos by channel id — provider-native video rows in `videos`
- YouTube channel videos by id or username — views, datesFetches a paginated list of videos uploaded by a YouTube channel, including each video's title, URL, thumbnail, view count (views), publish date, duration, and description.
- youtube.channel.videos — routed: best of 2 providers, own keys firstA YouTube channel's recent videos by channel id — provider-native video rows in `videos`
Comment replies
- YouTube comment replies by reply cursorRetrieve replies associated with a YouTube comment continuation cursor, with optional locale settings.
- YouTube comment replies by continuation tokenFetches replies to a specific comment on a YouTube video, including each reply's text content, author details (name, channel ID, avatar, verified/creator status), like count, and publish date.
- YouTube community post comments by post idYoutube: get post comments (web_v2)
Community post details
- YouTube community post details by post idYoutube: get post detail (web_v2)
- YouTube community post by URL — text, images, likesRetrieves the full details of a YouTube community post, including its text content, attached images, like count, publish date, and associated channel info.
Search channels
- Search within a YouTube channel by keywordYoutube: search channel (web)
- Search YouTube channels by keywordYoutube: search channels (web_v2)
Search YouTube Shorts by keyword
- Search YouTube Shorts by keywordYoutube: get shorts search (web_v2)
- Search YouTube Shorts by keywordYoutube: get shorts search v2 (web_v2)
- YouTube search suggestions by partial keywordYoutube: get search suggestions (web_v2)
Search videos
- YouTube search resultsThe videos YouTube finds for a query: title, link, video id, channel, views, when it was published (as YouTube says it, "3 years ago"), length and a short description. `limit` caps the rows (at most 20). A run takes about a second: YouTube's own search answer, plus one more call when it holds fewer videos than `limit`. Columns: title, url, video_id, channel, views, published, length, description.
- Search YouTube by keywordSearch YouTube by keyword with optional type, upload-date, duration, feature, and sort filters, or continue with a token.
- YouTube video search for a query — views, channelsSearch YouTube videos by keyword and get titles, channels, view counts and links
- Search YouTube videos by keywordYoutube: search video (web)
- Search YouTube by keyword with filtersYoutube: get general search (web_v2)
- Search YouTube videos by keyword and filtersSearch YouTube by keyword (filter type=video for videos only)
- Search YouTube videos by keywordSearch YouTube videos by keyword
- youtube.search.videos — routed: best of 4 providers, own keys firstSearch YouTube videos by keyword — provider-native video rows in `videos`
- Search YouTube by keyword — videos, channels, playlistsSearches YouTube by keyword query and returns matching videos, channels, playlists, shorts, shelves, and live streams.
- youtube.search.videos — routed: best of 4 providers, own keys firstSearch YouTube videos by keyword — provider-native video rows in `videos`
Trending videos
- YouTube trending videos by country and sectionYoutube: get trending videos (web)
- YouTube trending Shorts — views, likes, channelsFetches approximately 48 currently trending YouTube Shorts (viral/popular short-form videos) per call, returning each short's title, URL, thumbnail, view count (views), like count (likes), comment count, publish date, channel info, keywords, and duration.
Video captions
- Captions of a YouTube videoOne YouTube video's captions (its transcript) in one language, as one row: the whole text, the timed lines, whether they are auto-generated, and every caption language the video has. `video` is the watch URL, a youtu.be or shorts link, or the 11-character id; `language` a code such as en, es or pt-BR (default en), or `any` for the default captions. A person's track comes before an auto-generated one. No captions in that language gives no row and a warning listing the languages. 1 to 3 s; when YouTube refuses, a slower second source gives the default captions (billed even when it has none). Columns: video_id, title, language, is_auto_generated, available_languages, text, segments, url.
- YouTube video captions by video id or URLYoutube: get video captions (web_v2)
- YouTube video transcript by URL — captions, subtitlesRetrieves the captions, subtitles, or transcript of a YouTube video or short.
Video comments
- Comments of a YouTube videoThe top-level comments of one public YouTube video, in YouTube's top-comments order, one row per comment: text, author, likes, reply count, when it was posted, whether the creator hearted or pinned it. `video` is the watch URL, a youtu.be link or the 11-character id; `limit` how many comments (default 50, at most 500). YouTube sends 20 comments a page, about 0.5 s each. A video with comments turned off gives no rows. When YouTube stops answering partway, the comments read so far come back with a warning that the list stopped early. Columns: comment_id, video_id, text, author, likes, replies, published, published_date, hearted_by_creator, pinned, url.
- YouTube video comments by video idRetrieve first-level comments for a YouTube video with sorting, locale options, and cursor pagination.
- YouTube video comments by URL — replies, likes, authorsFetches comments and replies from a YouTube video, including each comment's text, author details, like count, reply count, and publish date.
- YouTube video comments by video idComments on a YouTube video
- List comments on a YouTube video by video idList the comments on a YouTube video (any public video, not just your own)
- YouTube video comments by video URLYoutube - Comments
- youtube.video.comments — routed: best of 3 providers, own keys firstComments on a YouTube video by id or URL — provider-native comment rows in `comments`
- youtube.video.comments — routed: best of 3 providers, own keys firstComments on a YouTube video by id or URL — provider-native comment rows in `comments`
Video details
- One YouTube video's factsOne YouTube video's facts from its page: title, channel and channel id, length, views, likes, publish date, category, keywords and the first 500 characters of the description. `video` is the watch URL, a youtu.be link or the 11-character id. The page needs a browser, so a run takes 8 to 45 seconds. Columns: title, channel, channel_id, length_s, views, likes, published, category, keywords, description, url.
- YouTube video metadata and stats by video idPublic metadata and stats for a YouTube video by video id
- YouTube video or short by URL — views, chapters, captionsFetches full details for a YouTube video or short, including title, description, thumbnail, view/like/comment counts, publish date, duration, chapters and caption tracks.
- YouTube video details by video idYoutube: get video info (web_v2)
- YouTube video details by video id or URLYoutube: get video info v2 (web_v2)
- YouTube video details by video idA single YouTube video's metadata and stats
- YouTube video stats by video id — views, likes, durationGet a YouTube video's metadata and stats (views, likes, comments, duration)
- YouTube video details by URLYoutube - Videos posts
- youtube.video.detail — routed: best of 4 providers, own keys firstOne YouTube video's details by id or URL — treg picks the provider and names the one that served
- youtube.video.detail — routed: best of 4 providers, own keys firstOne YouTube video's details by id or URL — treg picks the provider and names the one that served
Related videos
- YouTube related videos by video idYoutube: get relate video (web)
- YouTube related videos by video id or URLYoutube: get related videos (web_v2)
Video stream formats
- YouTube signed stream URL by video id and itagYoutube: get signed stream url (web_v2)
- YouTube video stream formats by video id or URLYoutube: get video streams (web_v2)
- YouTube video stream formats by video id or URLYoutube: get video streams v2 (web_v2)
- Set a custom thumbnail on your YouTube videoSet the custom thumbnail on one of your YouTube videos
- Upload a video to your YouTube channelUpload a video to your own YouTube channel
Account and utility endpoints
- Add a moderator to your YouTube live chatliveChatModerators.insert — Inserts a new resource into this collection.
- Add a section to your YouTube channel pagechannelSections.insert — Inserts a new resource into this collection.
- Add a video to your YouTube playlistplaylistItems.insert — Inserts a new resource into this collection.
- Ban a user from your YouTube live chatliveChatBans.insert — Inserts a new resource into this collection.
- Batch stats for your YouTube videos by video idsvideos.batchGetStats — Retrieves a batch of VideoStat resources, possibly filtered. BatchGetStats is intentionally not atomic to provide a better user experience.
- Bind a YouTube live broadcast to a streamliveBroadcasts.bind — Bind a broadcast to a stream.
- Check a YouTube video's trainability statusvideoTrainability.get — Returns the trainability status of a video.
- Create a YouTube live broadcastliveBroadcasts.insert — Inserts a new stream for the authenticated user.
- Create a YouTube live streamliveStreams.insert — Inserts a new stream for the authenticated user.
- Create a YouTube playlistplaylists.insert — Inserts a new resource into this collection.
- Create a third-party link on your YouTube channelthirdPartyLinks.insert — Inserts a new resource into this collection.
- Delete a YouTube commentcomments.delete — Deletes a resource.
- Delete a YouTube live chat messageliveChatMessages.delete — Deletes a chat message.
- Delete a caption track from your YouTube videocaptions.delete — Deletes a resource.
- Delete a section from your YouTube channel pagechannelSections.delete — Deletes a resource.
- Delete a third-party link from your YouTube channelthirdPartyLinks.delete — Deletes a resource.
- Delete your YouTube live broadcastliveBroadcasts.delete — Delete a given broadcast.
- Delete your YouTube live streamliveStreams.delete — Deletes an existing stream for the authenticated user.
- Delete your YouTube playlistplaylists.delete — Deletes a resource.
- Delete your YouTube playlist's cover imageplaylistImages.delete — Deletes a resource.
- Delete your YouTube videovideos.delete — Deletes a resource.
- Download a YouTube caption track by caption idcaptions.download — Downloads a caption track.
- File an abuse report on YouTubeabuseReports.insert — Inserts a new resource into this collection.
- Flag YouTube comments as spamcomments.markAsSpam — Expresses the caller's opinion that one or more comments should be flagged as spam.
- Insert a cuepoint into your YouTube live broadcastliveBroadcasts.insertCuepoint — Insert cuepoints in a broadcast
- Lift a YouTube live chat banliveChatBans.delete — Deletes a chat ban.
- Like, dislike or unrate a YouTube videovideos.rate — Adds a like or dislike rating to a video or removes a rating from a video.
- List Super Chat events on your YouTube channelsuperChatEvents.list — Retrieves a list of resources, possibly filtered.
- List YouTube channel subscriptionssubscriptions.list — Retrieves a list of resources, possibly filtered.
- List YouTube comments by id or parent comment idcomments.list — Retrieves a list of resources, possibly filtered.
- List YouTube content regionsi18nRegions.list — Retrieves a list of resources, possibly filtered.
- List YouTube interface languagesi18nLanguages.list — Retrieves a list of resources, possibly filtered.
- List YouTube live chat messages by chat idliveChatMessages.list — Retrieves a list of resources, possibly filtered.
- List YouTube video abuse report reasonsvideoAbuseReportReasons.list — Retrieves a list of resources, possibly filtered.
- List YouTube video categories by regionvideoCategories.list — Retrieves a list of resources, possibly filtered.
- List a YouTube channel's membersmembers.list — Retrieves a list of members that match the request criteria for a channel.
- List a YouTube channel's page sectionschannelSections.list — Retrieves a list of resources, possibly filtered.
- List a YouTube channel's recent activitiesactivities.list — Retrieves a list of resources, possibly filtered.
- List a YouTube playlist's cover imagesplaylistImages.list — Retrieves a list of resources, possibly filtered.
- List a YouTube video's caption tracks by video idcaptions.list — Retrieves a list of resources, possibly filtered.
- List a channel's YouTube playlistsplaylists.list — Retrieves a list of resources, possibly filtered.
- List moderators of your YouTube live chatliveChatModerators.list — Retrieves a list of resources, possibly filtered.
- List third-party links on your YouTube channelthirdPartyLinks.list — Retrieves a list of resources, possibly filtered.
- List your YouTube live broadcastsliveBroadcasts.list — Retrieve the list of broadcasts associated with the given channel.
- List your YouTube live streamsliveStreams.list — Retrieve the list of streams associated with the given channel. --
- List your YouTube membership pricing levelsmembershipsLevels.list — Retrieves a list of all pricing levels offered by a creator to the fans.
- Post a message to a YouTube live chatliveChatMessages.insert — Inserts a new resource into this collection.
- Post a top-level comment thread on YouTubecommentThreads.insert — Inserts a new resource into this collection.
- Remove a moderator from your YouTube live chatliveChatModerators.delete — Deletes a chat moderator.
- Remove a video from your YouTube playlistplaylistItems.delete — Deletes a resource.
- Remove your YouTube channel's watermark imagewatermarks.unset — Allows removal of channel watermark.
- Reply to a YouTube commentcomments.insert — Inserts a new resource into this collection.
- Report a YouTube video for abusevideos.reportAbuse — Report abuse for a video.
- Run a YouTube connectivity test calltests.insert — POST method.
- Search YouTube videos by hashtagSearches YouTube for content matching a specific hashtag and returns matching videos with title, URL, thumbnail, view count (views), publish date, duration, and channel info.
- Set moderation status of YouTube commentscomments.setModerationStatus — Sets the moderation status of one or more comments.
- Stream YouTube live chat messages by chat idmessages.stream — Allows a user to load live chat through a server-streamed RPC.
- Subscribe to a YouTube channelsubscriptions.insert — Inserts a new resource into this collection.
- Transition a YouTube live chat eventliveChatMessages.transition — Transition a durable chat event.
- Transition your YouTube live broadcast statusliveBroadcasts.transition — Transition a broadcast to a given status.
- Unsubscribe from a YouTube channelsubscriptions.delete — Deletes a resource.
- Update a caption track on your YouTube videocaptions.update — Updates an existing resource.
- Update a section on your YouTube channel pagechannelSections.update — Updates an existing resource.
- Update a third-party link on your YouTube channelthirdPartyLinks.update — Updates an existing resource.
- Update a video entry in your YouTube playlistplaylistItems.update — Updates an existing resource.
- Update your YouTube channel settingschannels.update — Updates an existing resource.
- Update your YouTube commentcomments.update — Updates an existing resource.
- Update your YouTube live broadcast settingsliveBroadcasts.update — Updates an existing broadcast for the authenticated user.
- Update your YouTube live stream settingsliveStreams.update — Updates an existing stream for the authenticated user.
- Update your YouTube playlist detailsplaylists.update — Updates an existing resource.
- Update your YouTube playlist's cover imageplaylistImages.update — Updates an existing resource.
- Update your YouTube video's metadatavideos.update — Updates an existing resource.
- Upload a banner image for your YouTube channelchannelBanners.insert — Inserts a new resource into this collection.
- Upload a caption track to your YouTube videocaptions.insert — Inserts a new resource into this collection.
- Upload a cover image for your YouTube playlistplaylistImages.insert — Inserts a new resource into this collection.
- Upload and set your YouTube channel watermark imagewatermarks.set — Allows upload of watermark image and setting it for a channel.
- YouTube ChannelFetch a YouTube channel's stats (subscribers, video count, total views, description) by handle or channel ID.
- YouTube Channel Community PostsList a YouTube channel's community posts by handle or channel ID with cursor pagination (text, likes, image, publish time).
- YouTube Channel Contact EmailReveal the business inquiry email a YouTube creator publishes behind the channel's View email address button. YouTube gates that address behind a signed-in Google session and a CAPTCHA, so it is absent from the channel page a logged-out scraper reads.
- YouTube Channel Live StreamsList a YouTube channel's live and past-live streams by handle or channel ID with cursor pagination (title, views, length, publish time).
- YouTube Channel PlaylistsList a YouTube channel's playlists by handle or channel ID with cursor pagination (title, video count, thumbnail).
- YouTube Channel ShortsList a YouTube channel's Shorts by handle or channel ID with cursor pagination, views, and publish timestamps.
- YouTube Channel VideosList a YouTube channel's videos by handle or channel ID with cursor pagination (title, views, length, publish time).
- YouTube Comment RepliesList replies to a YouTube comment using a continuation token with cursor pagination (text, author, likes, publish time).
- YouTube Community PostFetch a single YouTube community post by URL (text, images, channel, publish time).
- YouTube Hashtag SearchSearch YouTube videos by hashtag with cursor pagination (title, channel, views, length, publish time).
- YouTube PlaylistList every video in a YouTube playlist (title, length, and channel per video plus playlist owner and totals).
- YouTube SearchSearch YouTube and get matching videos (title, channel, views, length, publish time) as normalized JSON.
- YouTube Shorts SearchSearch YouTube Shorts by keyword and get matching Shorts (title, views, URL) with cursor pagination as normalized JSON.
- YouTube Trending ShortsList currently trending YouTube Shorts (title, channel, views, likes, duration).
- YouTube VideoFetch a YouTube video or Short's metadata (title, channel, views, likes, duration, publish date) by URL or ID.
- YouTube Video CommentsList the comments on a YouTube video or Short by URL with cursor pagination (text, author, likes, reply count).
- YouTube Video SponsorsDetect suspected sponsors and paid promotions in a YouTube video by URL (sponsor names, websites, confidence).
- YouTube Video TranscriptFetch the transcript/captions of a YouTube video or Short by URL or ID.
- YouTube Video Transcript (Provenance)Fetch a YouTube video or Short transcript with timed segments and its provenance: whether the words are creator-written captions or machine speech recognition.
- YouTube channel URL from channel idYoutube: get channel url (web)
- YouTube channel URL from channel idYoutube: get channel url (web_v2)
- YouTube channel id from channel URLYoutube: get channel id v2 (web)
- YouTube channel id from channel URLYoutube: get channel id (web_v2)
- YouTube channel id from channel nameYoutube: get channel id (web)
- YouTube channel live streams by id or usernameFetches live streams and past streams from a YouTube channel's Live tab, including title, URL, thumbnail, view count, publish time, duration, and a continuationToken when YouTube has more results.
- YouTube channel playlists by id or usernameFetches playlists from a YouTube channel's Playlists tab, including playlist ID, title, thumbnail, video count, channel info, playlist URL, and a continuationToken when YouTube has more results.
- YouTube channel videos by channel id, sortableYoutube: get channel videos v2 (web)
- YouTube comments for a video by video id, liveLive YouTube Comments provides real-time data on comments on the video you specify in the request.
- YouTube community post comment replies by tokenYoutube: get post comment replies (web_v2)
- YouTube location codes by countryYou will receive the list of locations by this API call.
- YouTube playlist videos by playlist idRetrieves all videos in a YouTube playlist, including the playlist title, owner info, total video count, and each video's title, URL, thumbnail, duration, and channel.
- YouTube search results for a keyword, liveLive SERP provides real-time data on the top 20 blocks of YouTube search engine results.
- YouTube subtitles for a video by video id, liveLive YouTube Subtitles provides real-time data on subtitles in the video you specify in the request.
- YouTube video captions by video id — SRT, XML, JSON3, textRetrieve available caption tracks for a YouTube video or request captions in SRT, XML, JSON3, or plain-text format.
- YouTube video captions result by job idYoutube: get video captions result (web_v2)
- YouTube video comment replies by tokenYoutube: get video comment replies (web_v2)
- YouTube video details by video id with stream formatsYoutube: get video info (web)
- YouTube video details by video id, liveLive YouTube Video Info provides real-time data on the video you specify in the request.
- YouTube video sponsors by URL (experimental)Experimental endpoint.
- YouTube video subtitles by subtitle URLYoutube: get video subtitles (web)
- Your ratings on YouTube videos by video idvideos.getRating — Retrieves the ratings that the authorized user gave to a list of specified videos.
These endpoints are callable but not part of the catalog's browse surface.