Skip to documentation
Browse documentation

YouTube API

Extract public YouTube videos, channels, Shorts, live broadcasts, comments, playlists, and search results.

Platform ID youtube
Endpoints 13 capabilities
View raw

Data limits

  • Transcripts are on hold and unavailable.
  • Comment and list dates retain YouTube’s displayed text, such as “1 year ago”. These relative dates are not exact timestamps; unavailable dates are omitted.
  • A Short’s duration may be unavailable. Missing durations are returned as null, never as zero.
  • Rounded counts such as “54M” are estimates. Their numeric values are marked with an approximate flag.

Capabilities

Every capability uses the same POST /execute envelope. Open an endpoint for its exact ID, input contract, code samples, cost, runtime, and illustrative output. Each endpoint lists its cost in credits per request; the pricing page shows what credits cost.

List channel community youtube.channel-community.list

Stream community posts from a channel's community tab.

From $1.25 per 1,000 requests · 1 credit
List channel live streams youtube.channel-live.list

Stream current, scheduled, and archived broadcasts from a channel's Live tab.

From $1.25 per 1,000 requests · 1 credit
List channel playlists youtube.channel-playlists.list

Stream playlists from a channel's playlists tab.

From $1.25 per 1,000 requests · 1 credit
List channel Shorts youtube.channel-shorts.list

List channel Shorts and view counts. Dates and durations may be unavailable. Rounded numeric counts are marked approximate.

From $1.25 per 1,000 requests · 1 credit
List channel videos youtube.channel-videos.list

List channel videos with pagination. Dates retain displayed relative text or are omitted. Rounded numeric counts are marked approximate.

From $1.25 per 1,000 requests · 1 credit
Get channel youtube.channel.get

Fetch metadata for a YouTube channel.

From $1.25 per 1,000 requests · 1 credit
List comments youtube.comments.list

Fetch top or newest video comments, or replies using a returned replies continuation. Published times retain YouTube’s displayed relative text; rounded counts are marked approximate.

From $1.25 per 1,000 requests · 1 credit
List hashtag videos youtube.hashtag.list

List the public videos shown on a hashtag hub. This is a ranked feed, not proven exhaustive membership.

From $1.25 per 1,000 requests · 1 credit
Get playlist youtube.playlist.get

Fetch playlist metadata and videos with pagination. Dates retain displayed text or are omitted. Rounded numeric counts are marked approximate.

From $1.25 per 1,000 requests · 1 credit
Get community post youtube.post.get

Fetch one public community post by URL or id, with its content, media, poll and public counts.

From $1.25 per 1,000 requests · 1 credit
Search youtube.search.query

Search videos, Shorts, channels, playlists and live broadcasts using the legacy filter or composable type, upload_date, duration and sort selectors.

From $1.25 per 1,000 requests · 1 credit
Search typeahead youtube.search.typeahead

Return YouTube's public anonymous search suggestions for a partial query. Suggestions are surface strings, not popularity metrics.

From $1.25 per 1,000 requests · 1 credit
Get video youtube.video.get

Get public video details, approximate counts and the replay heatmap when the source supplies it. Shorts duration may be null. Transcripts are held.

From $1.25 per 1,000 requests · 1 credit

Common uses

  • Track creator publishing and engagement across videos, Shorts, live streams, and community posts
  • Build searchable media, channel, playlist, and comment datasets for research and monitoring
  • Enrich creator intelligence and content-analysis workflows with normalized public metadata

Integration contract

A 200 response completed inline. A 202 response was queued; poll GET /jobs/:id until it reaches completed or failed.

Use YouTube data in Claude or connect another AI client with the MCP server.