YouTube Data & Media API

A fast and reliable API for accessing public YouTube data including videos, channels, comments, playlists, community posts, hashtag feeds, trending pages, captions, and streaming data.

This API is designed for developers who need structured YouTube data for apps, dashboards, analytics platforms, content tools, automation systems, and media products.

Why use this API

Easy integration with simple GET endpoints
Search videos, channels, and playlists
Retrieve video details, captions, and streaming info
Load channel videos, shorts, livestreams, posts, and playlists
Access comments and replies for videos and community posts
Support for pagination using continuation tokens
Language and region localization with hl and gl

Response format

All endpoints return JSON.

Typical response structure:

{ "ok": true, "data": { ... } }

Error response example:

{ "ok": false, "error": "input is required", "code": 422 }

Common Parameters

input

Main input value for the request. Depending on the endpoint, this can be:

YouTube video URL
Video ID
Channel URL
Channel handle such as @MrBeast
Playlist URL
Community post URL or post ID

continuation

A pagination token returned by the previous response. Use it to load the next page of results from the same endpoint.

How it works:

Send the first request without continuation
Read the continuation value from the response
Send that token back to the same endpoint to get the next page

Example:

GET /discovery/search?q=music GET /discovery/search?continuation=NEXT_PAGE_TOKEN

hl

Language code used for localized response text.

Examples:

hl=en - English
hl=uk - Ukrainian
hl=de - German
hl=fr - French

Use hl when you want interface text or localized metadata in a specific language.

gl

Two-letter country code used for regional YouTube context.

Examples:

gl=US - United States
gl=UA - Ukraine
gl=DE - Germany
gl=GB - United Kingdom

Use gl when results may depend on region, country availability, or localized YouTube behavior.

Discovery

Discovery endpoints help you search YouTube, resolve URLs, access trending content, and load hashtag feeds.

GET /discovery/resolve

Description: Resolve any supported YouTube input into a normalized target.

Parameters:

input required - video URL, channel URL, handle, playlist URL, post URL, or other supported YouTube input

Example request:

GET /discovery/resolve?input=https://www.youtube.com/watch?v=dQw4w9WgXcQ

GET /discovery/search

Description: Search YouTube content.

Parameters:

q optional - search query, required for the first page if continuation is not provided
result_type optional - one of all, video, channel, playlist
continuation optional - token for the next page

Example first page:

GET /discovery/search?q=lofi&result_type=video

Example next page:

GET /discovery/search?continuation=NEXT_PAGE_TOKEN

GET /discovery/trending

Description: Get the YouTube trending feed for a selected country.

Parameters:

country optional - 2-letter country code such as US, UA, DE
continuation optional - token for the next page

Example first page:

GET /discovery/trending?country=US

Example next page:

GET /discovery/trending?continuation=NEXT_PAGE_TOKEN

GET /discovery/hashtag

Description: Get videos for a hashtag feed.

Parameters:

tag optional - hashtag name with or without #; required for the first page if continuation is not provided
continuation optional - token for the next page

Example first page:

GET /discovery/hashtag?tag=shorts

Example next page:

GET /discovery/hashtag?continuation=NEXT_PAGE_TOKEN

Video

Video endpoints return metadata, streaming information, captions, playability status, and raw player data.

GET /video/details

Description: Get video details and metadata.

Parameters:

input required - video URL or video ID
hl optional - localization language
gl optional - localization country

Example:

GET /video/details?input=dQw4w9WgXcQ&hl=en&gl=US

GET /video/streaming

Description: Get video streaming data and media formats.

Parameters:

input required - video URL or video ID
hl optional - localization language
gl optional - localization country

Example:

GET /video/streaming?input=dQw4w9WgXcQ

GET /video/streaming-links

Description: Get direct media links when available.

Parameters:

input required - video URL or video ID
hl optional - localization language
gl optional - localization country

Example:

GET /video/streaming-links?input=https://www.youtube.com/watch?v=dQw4w9WgXcQ

GET /video/captions

Description: Get available captions and subtitle tracks for a video.

Parameters:

input required - video URL or video ID
hl optional - localization language
gl optional - localization country

Example:

GET /video/captions?input=dQw4w9WgXcQ

GET /video/playability

Description: Get playability status for a video.

Parameters:

input required - video URL or video ID
hl optional - localization language
gl optional - localization country

Example:

GET /video/playability?input=dQw4w9WgXcQ

GET /video/player

Description: Get raw player response data.

Parameters:

input required - video URL or video ID
hl optional - localization language
gl optional - localization country

Example:

GET /video/player?input=dQw4w9WgXcQ

Comments

Comments endpoints return comments for videos and community posts, as well as nested replies.

GET /comments

Description: Get comments for a video or community post.

Parameters:

input optional - video URL, video ID, post URL, or post ID; required for the first page if continuation is not provided
continuation optional - token for the next page
sort_by optional - one of top or newest
hl optional - localization language
gl optional - localization country

Example first page:

GET /comments?input=dQw4w9WgXcQ&sort_by=top

Example next page:

GET /comments?continuation=NEXT_PAGE_TOKEN

GET /comments/replies

Description: Get replies for a specific parent comment.

Parameters:

continuation required - replies token returned in the parent comments response
video_id optional - video ID for additional context
hl optional - localization language
gl optional - localization country

Example:

GET /comments/replies?continuation=REPLIES_TOKEN

Channel

Channel endpoints return home data, videos, shorts, livestreams, posts, podcasts, playlists, and channel-specific search results.

GET /channel

Description: Get main channel data.

Parameters:

input required - channel URL, handle, channel ID, or supported channel input

Example:

GET /channel?input=@MrBeast

GET /channel/videos

Description: Get channel videos.

Parameters:

input required - channel URL, handle, channel ID, or supported channel input
continuation optional - token for the next page
sort_by optional - one of latest, oldest, popular

Example first page:

GET /channel/videos?input=@MrBeast&sort_by=latest

Example next page:

GET /channel/videos?input=@MrBeast&continuation=NEXT_PAGE_TOKEN

GET /channel/shorts

Description: Get channel shorts.

Parameters:

input required - channel URL, handle, channel ID, or supported channel input
continuation optional - token for the next page

Example:

GET /channel/shorts?input=@MrBeast

GET /channel/livestreams

Description: Get channel livestreams.

Parameters:

input required - channel URL, handle, channel ID, or supported channel input
continuation optional - token for the next page

Example:

GET /channel/livestreams?input=@MrBeast

GET /channel/posts

Description: Get channel community posts.

Parameters:

input required - channel URL, handle, channel ID, or supported channel input
continuation optional - token for the next page

Example:

GET /channel/posts?input=@MrBeast

GET /channel/podcasts

Description: Get channel podcasts when available.

Parameters:

input required - channel URL, handle, channel ID, or supported channel input

Example:

GET /channel/podcasts?input=@MrBeast

GET /channel/playlists

Description: Get channel playlists.

Parameters:

input required - channel URL, handle, channel ID, or supported channel input
continuation optional - token for the next page

Example:

GET /channel/playlists?input=@MrBeast

GET /channel/search

Description: Search inside a specific channel.

Parameters:

input required - channel URL, handle, channel ID, or supported channel input
query required - search phrase inside the channel

Example:

GET /channel/search?input=@MrBeast&query=challenge

Pagination Guide

Some endpoints return a continuation value. This means more results are available.

Endpoints that support pagination:

/discovery/search
/discovery/trending
/discovery/hashtag
/comments
/comments/replies
/channel/videos
/channel/shorts
/channel/livestreams
/channel/posts
/channel/playlists

Pagination flow:

Make the first request using the main input parameter
Read continuation from the JSON response
Send the same endpoint again with that token

Localization Guide

Use hl and gl when you need localized or region-aware results.

hl controls language
gl controls regional context

Example:

GET /video/details?input=dQw4w9WgXcQ&hl=uk&gl=UA

Use Cases

Video and channel analytics dashboards
Media aggregation platforms
YouTube monitoring tools
Content research and discovery apps
Comment analysis systems
Playlist and channel tracking tools
Caption and subtitle integrations

Suggested Short Description

Fast YouTube API for video details, channels, comments, playlists, hashtags, captions, streaming data, and trending feeds.

Suggested Full Marketplace Description

YouTube Data & Media API gives developers simple and reliable access to public YouTube data. Search videos, resolve URLs, load channel content, fetch comments and replies, get captions, inspect streaming data, and work with trending and hashtag feeds through clean JSON endpoints.

The API supports video metadata, channel browsing, playlists, community posts, pagination with continuation tokens, and localized responses using language and region parameters.

It is a strong fit for SaaS products, analytics services, media apps, research tools, automation workflows, and any platform that needs structured YouTube data.

Suggested Tags

youtube, youtube api, youtube data api, youtube video api, youtube channel api, youtube comments api, youtube captions api, youtube playlist api, youtube search api, media api