The YouTube API for products and pipelines.

Retrieve supported public YouTube data — videos, channels and their tabs, comments, playlists, posts, transcripts, stream URLs, and search — through REST endpoints that return one consistent response model.

Get free API key View the docs

17 supported endpoints
Public data only
Fetched at request time

GET/v1/youtube/videos/{videoId}200OK

{
  "type": "Video",
  "name": "Planetary Defenders: This Is Not an Exercise",
  "published": "2026-10-14T15:05:17.000Z",
  "duration": 1215,
  "viewCount": 563991,
  "likeCount": 10246,
  "attributedTo": {
    "preferredUsername": "@NASA",
    "isVerified": true,
    "followerCount": 15100000
  }
}

What you can pull from YouTube.

On YouTube the channel is the unit, not the person behind it, and the endpoints follow the channel page tab by tab: videos, Shorts, streams, playlists, and posts each have their own feed. Channels are addressed by handle, the name in the channel URL, or by the channel id from an earlier response, which returns faster.

A video detail carries exact view and like counts, keywords, and the languages it has captions in. Listings show the rounded figures YouTube itself displays, and each endpoint says which it returns. Transcripts are a separate call in WebVTT, and the download endpoint returns every rendition YouTube serves rather than one file.

Every response uses the same ActivityStreams 2.0-based model as the other supported platforms, so a YouTube integration reuses the parsing you already wrote. Fields specific to YouTube stay as documented first-class fields rather than being flattened away.

YouTube data

Channel profiles and About details
Video, Shorts, stream, playlist, and post tabs
Single videos with captions listed
Comments and reply threads
Transcripts in WebVTT and stream URLs
Search, tag feeds, and search suggestions

All 17 YouTube endpoints.

Grouped by what they return. Every one has its parameter contract, a request you can copy, and an example response.

Profiles

The channel record, and its About panel with the exact lifetime view count, creation date, and country.

Get channelReturns a public YouTube channel: name, handle, description, avatar, banner, subscriber and video counts, links, and RSS feed.GET /v1/youtube/channels/{channel}Get channel about pageReturns a public YouTube channel's About panel: full description, lifetime view count, creation date, and country.GET /v1/youtube/channels/{channel}/about

Feeds

The channel page tab by tab: uploads, Shorts, streams, playlists, and posts, each its own feed.

Get channel videosReturns a public YouTube channel's uploaded videos, most recent first.GET /v1/youtube/channels/{channel}/videos Get channel shortsReturns a public YouTube channel's Shorts, most recent first.GET /v1/youtube/channels/{channel}/shorts Get channel streamsReturns a public YouTube channel's streams, past broadcasts and any live now, most recent first. Returns an empty list when the channel has never streamed.GET /v1/youtube/channels/{channel}/streams Get channel playlistsReturns a public YouTube channel's Playlists tab, in the order YouTube displays them. Returns an empty list when the channel has no playlists.GET /v1/youtube/channels/{channel}/playlists Get channel postsReturns a public YouTube channel's posts, most recent first.GET /v1/youtube/channels/{channel}/posts

Posts

One video, playlist, or post by id, plus a video’s WebVTT transcript and its downloadable renditions.

Get playlist videosReturns a public YouTube playlist's videos, in playlist order.GET /v1/youtube/playlists/{playlistId}Get videoReturns a public YouTube video: title, description, counts, publish date, channel, thumbnails, keywords, and available caption languages. For the…GET /v1/youtube/videos/{videoId}Get video transcriptYouTube API: Returns the transcript for a public video, in WebVTT format.GET /v1/youtube/videos/{videoId}/transcript Get video download URLsReturns every rendition YouTube serves for this video, each with a direct file URL you can download with a plain GET request: no cookies, auth headers, or…GET /v1/youtube/videos/{videoId}/download Get community postReturns a single YouTube community post.GET /v1/youtube/posts/{postId}

Comments

Top-level comments on a video, and the replies under any one of them.

Get video commentsReturns a public YouTube video's top-level comments, roughly 20 per page. On the first page, totalItems is the video's exact comment count, replies…GET /v1/youtube/videos/{videoId}/comments Get comment repliesReturns a YouTube comment's replies, addressed by the video and comment ids.GET /v1/youtube/videos/{videoId}/comments/{commentId}/replies

Discovery

Where a run starts without an id: keyword search, the videos under a tag, and YouTube’s own search-box suggestions.

Get videos with tagReturns videos tagged with a YouTube hashtag. Not paginated — YouTube returns a single page of results for a hashtag.GET /v1/youtube/tags/{tag}Search videosSearches public YouTube videos. YouTube has no public trending chart; sorting by view count within an upload window (order, published) is the closest…GET /v1/youtube/search Get search suggestionsReturns YouTube's search-box autocomplete suggestions for a partial query. Not paginated.GET /v1/youtube/search/typeahead

How the calls fit together.

Few YouTube jobs are a single request. Most are two or three chained, each call keyed by an id the one before it returned.

Vet a channel

Read the channel for its size, the About panel for its exact lifetime views and age, then its latest uploads.

Turn a video into text

Read the video to see which caption languages exist, then fetch the transcript in the one you need.

Read the reaction to a video

Page the top-level comments, then open the reply thread under the ones that started a conversation.

What shapes your YouTube integration.

Page sizes, ordering, and what the platform itself withholds — the details that decide how you build, settled before you write a line of code.

01Most counts are YouTube’s rounded figures: Subscriber and video counts, and view counts on channel listings and playlists, are the rounded values YouTube displays, returned as integers (515M becomes 515000000). A video detail returns exact view and like counts, the About panel an exact lifetime view count, and search an exact view count.
02Channels take a handle, and optionally an id: Every channel endpoint takes the handle from the channel URL, with or without the @. If you already have the channel id, pass it too: it is used instead of the handle and returns faster.
03Stream URLs come in parts above 360p: The download endpoint returns every rendition YouTube serves. Complete files with audio only go up to 360p; above that, combine a video rendition with an audio one. URLs expire after a few hours.
04There is no trending chart: YouTube has no public trending chart. Sorting search by view count within an upload window is the closest equivalent: results for a query, not a platform-wide ranking.

Read the YouTube reference Make your first request

Other platforms

Build on YouTube data.

Get a free API key and call any of these endpoints in minutes. No credit card required.

Get free API key YouTube reference