YouTube API
Extract public YouTube videos, channels, Shorts, live broadcasts, comments, playlists, and search results.
youtube
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.
youtube.channel-community.list
Stream community posts from a channel's community tab.
youtube.channel-live.list
Stream current, scheduled, and archived broadcasts from a channel's Live tab.
youtube.channel-playlists.list
Stream playlists from a channel's playlists tab.
youtube.channel-shorts.list
List channel Shorts and view counts. Dates and durations may be unavailable. Rounded numeric counts are marked approximate.
youtube.channel-videos.list
List channel videos with pagination. Dates retain displayed relative text or are omitted. Rounded numeric counts are marked approximate.
youtube.channel.get
Fetch metadata for a YouTube channel.
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.
youtube.hashtag.list
List the public videos shown on a hashtag hub. This is a ranked feed, not proven exhaustive membership.
youtube.playlist.get
Fetch playlist metadata and videos with pagination. Dates retain displayed text or are omitted. Rounded numeric counts are marked approximate.
youtube.post.get
Fetch one public community post by URL or id, with its content, media, poll and public counts.
youtube.search.query
Search videos, Shorts, channels, playlists and live broadcasts using the legacy filter or composable type, upload_date, duration and sort selectors.
youtube.search.typeahead
Return YouTube's public anonymous search suggestions for a partial query. Suggestions are surface strings, not popularity metrics.
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.
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.
- Authenticate REST requests
- Poll jobs and retrieve results
- Handle errors and safe retries
- Understand credits and limits
Use YouTube data in Claude or connect another AI client with the MCP server.