YouTube API

19 endpoints for public YouTube data, from 1 credit a call. Same response format and field names as every other platform.

curl "https://scrapeio.com/v1/youtube/channel?handle=nike" \
  -H "x-api-key: YOUR_KEY"

For agents/platforms/youtube.md/skill.mdMCP: 19 tools

GET/v1/youtube/channel1 credit

YouTube channel: subscribers, total views, video count, description.

Parameter	Type	Description
`handle`required	string	Channel @handle, channel URL, or UC… channel id.

curl "https://scrapeio.com/v1/youtube/channel?handle=nike" \
  -H "x-api-key: YOUR_KEY"

GET/v1/youtube/channel-videos1 credit

A channel's uploads (videos and Shorts), newest first, with views, likes and comments.

Parameter	Type	Description
`handle`required	string	Channel @handle, channel URL, or UC… channel id.
`cursor`	string	Cursor from the previous page's data.cursor.

curl "https://scrapeio.com/v1/youtube/channel-videos?handle=nike" \
  -H "x-api-key: YOUR_KEY"

GET/v1/youtube/video1 credit

One YouTube video or Short by URL: views, likes, comments, duration, tags.

Parameter	Type	Description
`url`required	string	YouTube video or Short URL.

curl "https://scrapeio.com/v1/youtube/video?url=..." \
  -H "x-api-key: YOUR_KEY"

GET/v1/youtube/video/comments1 credit

Comments on a YouTube video.

Parameter	Type	Description
`url`required	string	YouTube video URL.
`order`	relevance, time	Ranking. Default: relevance.
`cursor`	string	Cursor from the previous page's data.cursor.

curl "https://scrapeio.com/v1/youtube/video/comments?url=..." \
  -H "x-api-key: YOUR_KEY"

GET/v1/youtube/search2 credits

Search YouTube videos with full stats.

Parameter	Type	Description
`query`required	string	Search text.
`sort_by`	relevance, date, viewCount, rating	Ranking. Default: relevance.
`published_after`	string	RFC 3339 time, e.g. 2026-01-01T00:00:00Z.
`cursor`	string	Cursor from the previous page's data.cursor.

curl "https://scrapeio.com/v1/youtube/search?query=coffee" \
  -H "x-api-key: YOUR_KEY"

GET/v1/youtube/video/download2 credits

Direct MP4 stream URLs for a video (360p with audio, plus every format).

Parameter	Type	Description
`url`required	string	YouTube video URL.

curl "https://scrapeio.com/v1/youtube/video/download?url=..." \
  -H "x-api-key: YOUR_KEY"

GET/v1/youtube/playlist1 credit

A playlist's details and its videos, with views and likes.

Parameter	Type	Description
`playlist_id`required	string	Playlist id or playlist URL.
`cursor`	string	Cursor from the previous page's data.cursor.

curl "https://scrapeio.com/v1/youtube/playlist?playlist_id=..." \
  -H "x-api-key: YOUR_KEY"

GET/v1/youtube/channel/playlists1 credit

A channel's public playlists.

Send one of: handle, channelId.

Parameter	Type	Description
`handle`	string	Channel handle, e.g. @MrBeast.
`channelId`	string	Channel id (UC...). Send this or handle.
`cursor`	string	Cursor from the previous page's data.cursor.

curl "https://scrapeio.com/v1/youtube/channel/playlists?handle=nike" \
  -H "x-api-key: YOUR_KEY"

GET/v1/youtube/channel/shorts1 credit

A channel's Shorts, newest first, with views and likes.

Send one of: handle, channelId.

Parameter	Type	Description
`handle`	string	Channel handle, e.g. @MrBeast.
`channelId`	string	Channel id (UC...). Send this or handle.
`cursor`	string	Cursor from the previous page's data.cursor.

curl "https://scrapeio.com/v1/youtube/channel/shorts?handle=nike" \
  -H "x-api-key: YOUR_KEY"

GET/v1/youtube/channel/lives1 credit

A channel's past and current live streams.

Send one of: handle, channelId.

Parameter	Type	Description
`handle`	string	Channel handle, e.g. @MrBeast.
`channelId`	string	Channel id (UC...). Send this or handle.
`cursor`	string	Cursor from the previous page's data.cursor.

curl "https://scrapeio.com/v1/youtube/channel/lives?handle=nike" \
  -H "x-api-key: YOUR_KEY"

GET/v1/youtube/video/comment/replies1 credit

Replies to one YouTube comment.

Parameter	Type	Description
`comment_id`required	string	Comment id from the comments endpoint.
`cursor`	string	Cursor from the previous page's data.cursor.

curl "https://scrapeio.com/v1/youtube/video/comment/replies?comment_id=..." \
  -H "x-api-key: YOUR_KEY"

GET/v1/youtube/search/typeahead1 credit

Search suggestions YouTube shows as you type.

Parameter	Type	Description
`query`required	string	Partial search text.

curl "https://scrapeio.com/v1/youtube/search/typeahead?query=coffee" \
  -H "x-api-key: YOUR_KEY"

GET/v1/youtube/channel/community-posts1 credit

A channel's community posts: text, images, polls, likes and comments.

Send one of: handle, channelId.

Parameter	Type	Description
`handle`	string	Channel handle, e.g. @MrBeast.
`channelId`	string	Channel id (UC...). Send this or handle.
`cursor`	string	Cursor from the previous page's data.cursor.
`continuationToken`	string	Same as cursor, under ScrapeCreators' name.

curl "https://scrapeio.com/v1/youtube/channel/community-posts?handle=nike" \
  -H "x-api-key: YOUR_KEY"

GET/v1/youtube/community-post1 credit

One community post with its text, images and likes.

Parameter	Type	Description
`url`required	string	Community post URL.

curl "https://scrapeio.com/v1/youtube/community-post?url=..." \
  -H "x-api-key: YOUR_KEY"

GET/v1/youtube/channel/search1 credit

Search inside one channel's videos.

Send one of: handle, channelId.

Parameter	Type	Description
`handle`	string	Channel handle, e.g. @MrBeast.
`channelId`	string	Channel id (UC...). Send this or handle.
`query`required	string	Search text.
`cursor`	string	Cursor from the previous page's data.cursor.
`continuationToken`	string	Same as cursor, under ScrapeCreators' name.

curl "https://scrapeio.com/v1/youtube/channel/search?query=coffee" \
  -H "x-api-key: YOUR_KEY"

GET/v1/youtube/search/hashtag1 credit

Videos under a YouTube hashtag, with views and length.

Parameter	Type	Description
`hashtag`required	string	Hashtag, with or without #.
`cursor`	string	Cursor from the previous page's data.cursor.
`continuationToken`	string	Same as cursor, under ScrapeCreators' name.

curl "https://scrapeio.com/v1/youtube/search/hashtag?hashtag=travel" \
  -H "x-api-key: YOUR_KEY"

GET/v1/youtube/shorts/trending5 credits

Trending Shorts

No parameters.

curl "https://scrapeio.com/v1/youtube/shorts/trending" \
  -H "x-api-key: YOUR_KEY"

GET/v1/youtube/video/sponsors5 credits

Video Sponsors

Parameter	Type	Description
`url`required	string	YouTube video or short URL
`language`	string	2 letter language code used for transcript lookup, ie 'en', 'es', 'fr' etc.

curl "https://scrapeio.com/v1/youtube/video/sponsors?url=..." \
  -H "x-api-key: YOUR_KEY"

GET/v1/youtube/video/transcript5 credits

Transcript

Parameter	Type	Description
`url`required	string	YouTube video or short URL
`language`	string	Language code, ie 'en', 'es', 'fr' or 'en-US'.
`original_audio`	boolean	Set to true to return captions only in the original spoken language identified by YouTube.
`cache_max_age`	1d, 3d, 7d, 14d, 30d	If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with "cached": true and a "ca

curl "https://scrapeio.com/v1/youtube/video/transcript?url=..." \
  -H "x-api-key: YOUR_KEY"

YouTube API

Other platforms