# YouTube Scraper API: 21 Endpoints, Typed JSON | Scrapier (https://scrapier.io/scrapers/youtube/)

> YouTube scraper API with 21 endpoints: channels, videos, Shorts, comments, transcripts and trending as typed JSON. 2 credits per call. Get a free API key.

Last updated: 2026-11-10

## YouTube Scraper API: _21 endpoints_, structured JSON

Channels, videos, Shorts, live streams, comments, transcripts, playlists, community posts, search and trending charts: every YouTube endpoint Scrapier ships, each returning typed JSON in the same response envelope. Public data only.

[Get a free API key →](https://app.scrapier.io/sign-up)

Copy for your AI agent

**21**YouTube endpoints

**1–2**credits per successful call

**0**credits for a failed call

**17**need no YouTube login

Quick answerScrapier returns typed JSON from **21 YouTube endpoints**: channels, videos, Shorts, live streams, comments, transcripts, playlists, community posts, search and trending. Public data only and no proxies; no YouTube login needed. 1 or 2 credits per successful call; failed calls are free. Last verified 9 Nov 2026

Endpoints

## What data can I extract with YouTube Scraper?

Pick the data you need. Each endpoint takes a channel handle, a video or playlist link, or a keyword and gives you clean JSON back, for 2 credits per successful call.

[### Channel info

`**GET**/api/v2/youtube-channel-info/`

One channel record: about section, stats and the first page of videos, Shorts, live streams and posts.

1 credit per call_View →Page soon_](https://scrapier.io/scrapers/youtube/channel/)[### Channel videosStart here

`**GET**/api/v2/youtube-channel-video-scraper/`

A channel's videos, Shorts or both, a page at a time, with title, views, duration and publish time.

1 credit per call_View →Page soon_](https://scrapier.io/scrapers/youtube/channel-videos/)[### Channel live streams

`**GET**/api/v2/youtube-channel-live/`

A channel's live streams and past broadcasts, with view count and length.

1 credit per call_View →Page soon_](https://scrapier.io/scrapers/youtube/channel-live/)

### Shorts

`**GET**/api/v2/youtube-shorts/`

One Short by URL or ID, or a channel's Shorts tab newest first, with views, likes and comments.

1 credit per call_View →Page soon_

[### Video details

`**GET**/api/v2/youtube-video-details/`

One video by URL: title, channel, description, views, likes, duration, tags and upload date.

1 credit per call_View →Page soon_](https://scrapier.io/scrapers/youtube/video/)

### Subtitles and transcript

`**GET**/api/v2/youtube-subtitles/`

Subtitles and transcript text of a video, with language and whether captions are auto-generated.

1 credit per call_View →Page soon_

### Playlist videos

`**GET**/api/v2/youtube-playlist/`

Every video in a public playlist, with position, duration and views, plus the playlist's own details.

1 credit per call_View →Page soon_

### Video sponsors

`**GET**/api/v2/youtube-video-sponsors/`

Suspected sponsors of a video, detected from its description, links and transcript.

1 credit per call_View →Page soon_

### Video thumbnails

`**GET**/api/v2/youtube-video-thumbnail/`

Every thumbnail size of a video, or of a channel's videos, with real dimensions and frame images.

1 credit per call_View →Page soon_

### Most replayed

`**IN**YOUTUBE_URLS`

The most replayed parts of a video with its heat map, plus title, channel, views, likes and comments.

Same API key and JSON envelope

### Video summarizer

`**IN**YOUTUBE_VIDEO_URL`

A video's metadata, channel, transcript, tags, hashtags and engagement rate in one record.

Same API key and JSON envelope

[### Comments

`**GET**/api/v2/youtube-comments-scraper/`

Comments on a video, top or newest first, with author, likes, reply count and creator heart.

1 credit per call_View →Page soon_](https://scrapier.io/scrapers/youtube/comments/)[### Comment replies

`**GET**/api/v2/youtube-comment-replies/`

All replies in one comment thread, from the thread's reply continuation token.

1 credit per call_View →Page soon_](https://scrapier.io/scrapers/youtube/comment-replies/)[### Community posts

`**GET**/api/v2/youtube-community-posts/`

A channel's community posts with text, image, likes and comment count.

1 credit per call_View →Page soon_](https://scrapier.io/scrapers/youtube/community-posts/)

### Search

`**GET**/api/v2/youtube-search-full/`

Videos, Shorts and streams that match a keyword, with filters, channel data and optional subtitles.

2 credits per call_View →Page soon_

[### Search suggestions

`**GET**/api/v2/youtube-search-suggestions/`

Autocomplete suggestions YouTube shows for a search term, with entity data.

1 credit per call_View →Page soon_](https://scrapier.io/scrapers/youtube/search-suggestions/)[### Hashtag videos

`**GET**/api/v2/youtube-hashtag-videos/`

Videos and Shorts under a hashtag, with channel, views and publish date.

1 credit per call_View →Page soon_](https://scrapier.io/scrapers/youtube/hashtag-videos/)[### Trending

`**GET**/api/v2/youtube-trending/`

Trending charts by country: music, trailers, gaming and more, with chart position and views.

1 credit per call_View →Page soon_](https://scrapier.io/scrapers/youtube/trending/)

### Trending Shorts

`**GET**/api/v2/youtube-trending-shorts/`

Shorts from a hashtag feed such as #trendingshorts, by country, with sort options.

1 credit per call_View →Page soon_

### Channel email finder

`**IN**keywords`

Public emails found on YouTube pages for a keyword, with the page title, description and URL.

Live on the Social media emails page

### Phone number finder

`**IN**keywords`

Public phone numbers found on YouTube pages for a keyword, with country, dial code and page URL.

Same API key and JSON envelope

Playground

## Try YouTube Scraper Live

Pick an endpoint, fill in the input and press **Run**. Without a key you see the catalog sample and nothing is billed. With your API key it runs a real call from your browser.

YouTube**Channel info**Live

Platform

Endpoint

Parameters

### \+ Run live with your API key

Response

Sample dataCatalog sample, run to see live data

Pricing

## How much will scraping YouTube cost?

Every successful call costs 1 or 2 credits, whether the page holds one profile or a page of comments. Failed calls cost nothing. A free tier lets you try it first.

On Pro, 1,000 calls at 2 credits cost $3.16. Scale brings that to $2.39, so 125,000 YouTube calls a month is $299.

[See all plans →](https://scrapier.io/pricing/)

| Plan | Price / mo | Credits / mo | Per 1,000 calls |
| --- | --- | --- | --- |
| Free | $0 | Free tier | — |
| Hobby | $29 | 15,000 | $3.87 |
| Pro | $79 | 50,000 | $3.16 |
| Scale | $299 | 250,000 | $2.39 |

How to

## How do I use YouTube Scraper?

Built to be easy to start with, even if you've never scraped a website. Here's how to get YouTube data in a few minutes:

[Get a free API key →](https://app.scrapier.io/sign-up)

1. **Create a free Scrapier account**[Sign up](https://app.scrapier.io/sign-up) with your email and copy your API key.
2. **Pick the endpoint for your data**Channels, videos, Shorts, comments, transcripts, playlists, search or trending.
3. **Add your input**One channel handle, video or playlist URL, hashtag or keyword per call.
4. **Page through the results**List endpoints return `next_cursor`; pass it back as `cursor` for the next page.
5. **Or search instead**Send a keyword in `queries` to `youtube-search-full` or `youtube-search-suggestions`.
6. **Run the request**One GET with your key in the `X-API-Key` header, or ask your AI agent over MCP.
7. **Save the results**JSON from the API: store it as is, or flatten it to CSV in a few lines.

Input

## Input

Two ways in. Use whichever matches what you already have.

1

### By URL

You already have the links to the pages you want.

Channel info`MrBeast`

Video details`youtube.com/watch?v=dQw4w9WgXcQ`

Playlist videos`youtube.com/playlist?list=PLObrtcm1Kw6Odq5ks2R3bbJUGVVwQF-vw`

Comments`youtube.com/watch?v=uKv3mi2t2KE`

Best forknown pages · paste the link as it is

2

### By keyword

You don't know the items yet: find them with a keyword.

fitness

SearchSearch suggestions

- **30-minute fitness wor…**1.2M viewCount

Best fordiscovery · plain text, "travel" not "#travel"

Example requests

// GET /api/v2/youtube-channel-video-scraper/
{
  "youtube\_channels": "@mrbeast",
  "scrape\_type": "videos"
}
// or
// GET /api/v2/youtube-channel-info/
{
  "urls": "MrBeast"
}

| Send this | Parameter | And you can get |
| --- | --- | --- |
| Channel handle or URL | `youtube_channels` · `urls` · `channels` | Channel info, videos, Shorts, live streams, community posts |
| Video URL | `urls` · `video_ids` | Video details, transcript, comments, sponsors, thumbnails |
| Playlist URL | `urls` | Every video in the playlist and the playlist's details |
| Keyword or hashtag | `queries` · `hashtags` | Search results, suggestions, hashtag videos |
| Country | `country_code` | Trending charts for that country |

Optional on list endpoints: `cursor` (pass back `next_cursor` for the next page). Auth is one header: `X-API-Key`. Send parameters in the query string (GET) or as a JSON body (POST).

Output

## Output

The one thing to know: **each data type has its own shape**. Field names stay the same on every call, so code and agents read them directly. Samples below come from the live catalog.

// GET /api/v2/youtube-channel-video-scraper/?youtube\_channels=@mrbeast
// one item of data.items · catalog sample
{
  "author\_name": "@mrbeast",
  "video\_title": "I Survived The Most Extreme Places On Earth",
  "publish\_time": "8 days ago",
  "view\_count": "91M views",
  "video\_duration": "23 minutes, 28 seconds",
  "video\_url": "https://www.youtube.com/watch?v=gTKS8SAwUzE",
  "cover\_image\_url": "https://i.ytimg.com/vi/gTKS8SAwUzE/hq720\_custom\_2.jpg",
  "video\_id": "gTKS8SAwUzE",
  "content\_type": "video",
  "channel\_id": "UCX6OQ3DkcsbYNE6H8uQQuVA",
  "browse\_id": "UCX6OQ3DkcsbYNE6H8uQQuVA",
  "input\_channel": "@mrbeast",
  "scraped\_at": "2026-09-14T09:23:02.131Z"
}

Every response is `{"success": true, "data": {…}}`: your input echoed back, the result under its own key (`profile`, `posts`, `comments`…) and `next_cursor` for the next page.

Use cases

## What can you do with YouTube data?

Public YouTube data powers influencer marketing, content research, sponsorship tracking, audience research and AI training sets. Here are five common jobs, and the YouTube scraper endpoints each one chains together.

01

### Creator and sponsorship research

Find channels in your niche through search, pull each channel's recent videos and views, then see which brands already sponsor them. Shortlist creators who reach your audience and work with brands like yours.

1. _1_search-full
2. _2_channel-info
3. _3_channel-video-scraper
4. _4_video-sponsors
5. Shortlist

WeeklyCreator CRM, Sheets

02

### Content and keyword research

Collect the autocomplete suggestions for a topic, then the videos that rank for each one and how many views they get. Plan titles and topics around what people really search for.

1. _1_search-suggestions
2. _2_search-full
3. Topic map

WeeklySheets, Notion

03

### Competitor channel monitoring

Track competitor channels for upload cadence, views per video and their Shorts. Read the comments on their best videos to learn what their viewers ask for.

1. _1_channel-video-scraper
2. _2_shorts
3. _3_comments-scraper
4. Benchmark

WeeklyDashboard

04

### Transcripts for AI and RAG

Turn a playlist or channel into text: list its videos, then pull each video's transcript and details. Feed the text to a search index, a RAG pipeline or an LLM summarizer.

1. _1_playlist
2. _2_video-details
3. _3_subtitles
4. Text corpus

On demandVector DB, LLM

05

### Trend tracking

Read the trending charts by country and the trending Shorts feed every day. See which songs, trailers and formats are rising, and which channels publish them.

1. _1_trending
2. _2_trending-shorts
3. _3_hashtag-videos
4. Trend digest

DailyEmail digest, dashboard

Features

## Features

YouTube Scraper fetches clean, structured YouTube data at low cost: built for creator research, content planning, transcript pipelines and AI agents.

### Live data, every call

Each request reads YouTube at call time, and the response says when in `scraped_at`.

### Typed, consistent JSON

Same field names on every call, ready for code, sheets or an LLM.

### Lists, page by page

List endpoints return `next_cursor`; run up to 3 requests in parallel per key.

### 17 live endpoints, one shape

Channels, videos, Shorts, comments, transcripts and charts share the same envelope and auth.

### MCP-ready for AI agents

The Scrapier MCP server reaches every endpoint from Claude Code, Cursor, Windsurf and VS Code with one command.

### Works with your stack

Plain REST: Python, Node.js, cURL, n8n, Make, Zapier or Google Sheets.

### No quota, no OAuth

Public data only. No Google Cloud project, daily quota units or OAuth consent screen; every endpoint works without a YouTube login.

### Maintained for you

When YouTube changes its pages, Scrapier updates the scraper; your field names stay the same.

### Pay per successful call

2 credits per call, however many items the page holds. Failed calls are never billed.

Why Scrapier

## Why choose this YouTube Scraper?

The official YouTube Data API is free, but it runs on a daily quota of units per Google Cloud project, and some data it does not offer, such as transcripts of other people's videos. Scrapier reads any public channel, video, comment or transcript with one API key, at a price you know before the call runs.

[Get a free API key →](https://app.scrapier.io/sign-up)[See pricing](https://scrapier.io/pricing/)

**0**Credits for a failed call

Any non-2xx response is free, so retries cost nothing.

**$2.39**Per 1,000 calls on Scale

At 2 credits a call. Flat per-call pricing, no quota units to budget.

**0**Google Cloud projects

No API project, quota request or OAuth setup before the first call.

**1 key**For 35 platforms

The same key and JSON envelope cover TikTok, Instagram, Rumble, Reddit and more.

| Feature | Scrapier YouTube Scraper | YouTube Data API | DIY scraper |
| --- | --- | --- | --- |
| Whose data | Any public channel or video | Any public channel or video | Any public channel or video |
| Transcripts | Any video with captions | Only videos you are allowed to edit | Build and maintain a caption parser |
| Setup | One API key | Google Cloud project, API key or OAuth | Proxies, browsers, parsers |
| Cost | From $2.39 per 1,000 calls | Free, within a daily quota of units | Servers, proxies and engineering time |
| AI agents | MCP server included | None | Build your own |

FAQ

## Frequently asked questions

### Can I scrape several data types in one call?

No. Each endpoint returns one data type. To get a channel's videos and their comments, call youtube-channel-video-scraper then youtube-comments-scraper for each video, or let an AI agent chain the calls over MCP.

### Can I get YouTube transcripts?

Yes. Send a video URL to youtube-subtitles and you get the transcript text, the language and whether the captions are auto-generated. A video with no captions returns no transcript.

### Can I scrape private or unlisted videos?

No. Scrapier reads public data only. Private videos are not returned; an unlisted video can only be read if you already have its link, the same as any visitor.

### Why don't some counts match what I see on YouTube?

Counts are a snapshot from the moment of the call, so compare against scraped\_at. Some endpoints also keep YouTube's own text, such as "91M views", next to or instead of an integer; check the field type in the output sample.

### How many results can I get?

As many as YouTube shows publicly. List endpoints return a page at a time with next\_cursor; pass it back as cursor for the next page. Each page is one call at 2 credits.

### How do I get replies to a YouTube comment?

youtube-comment-replies takes the reply continuation token of one comment thread in continuation\_tokens and returns that whole thread, with the replies nested inside. youtube-comments-scraper gives you the top-level comments and their reply counts.

### Is it legal to scrape YouTube?

It depends on what you collect, where you are and how you use it, so this is not legal advice. Scrapier returns publicly visible data only. Commenter names can be personal data under GDPR or CCPA, so collect only what you have a legitimate reason to use.

### Can I connect YouTube data to other tools?

Yes. Any tool that can make an HTTP request works: n8n, Make, Zapier, Google Sheets, Airbyte or your own code. Send your key in the X-API-Key header.

### Can I get YouTube data through an MCP server?

Yes. Run claude mcp add -t http scrapier https://mcp.scrapier.io/mcp with your key in an X-API-Key header. The agent finds the right YouTube endpoint with search\_endpoints and calls it with run\_scrape, in Claude Code, Cursor or Windsurf.

### YouTube Scraper not working?

Check the status code first: 401 means the X-API-Key header is missing, 403 an invalid key, 402 no credits left, 429 too many requests (wait Retry-After seconds). If it's still wrong, report it with the request and the response.

### How much does the YouTube scraper cost?

Each YouTube endpoint costs 2 credits per successful call, however many items the page holds. Failed calls are free. Plans: Hobby $29 for 15,000 credits, Pro $79 for 50,000, Scale $299 for 250,000, Enterprise custom. A free tier lets you try it first.

### What are the YouTube scraper rate limits?

Run up to 3 requests in parallel per API key. If you go faster, the API answers 429 with a Retry-After header: wait that many seconds and retry. 429 and 5xx responses are never billed, and long-running endpoints need a client timeout of 210 seconds or more.

### How do I scrape YouTube with Python?

Use the requests library: requests.get("https://proxy.scrapier.io/api/v2/youtube-video-details/", headers={"X-API-Key": key}, params={"urls": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"}, timeout=210). The response is JSON, so read r.json()\["data"\]\["videos"\] directly; there is no HTML to parse.

Other platforms

## You might also like

[### TikTok

29 endpoints](https://scrapier.io/scrapers/tiktok/)[### Instagram

20 endpoints](https://scrapier.io/scrapers/instagram/)[### Rumble

5 endpoints](https://scrapier.io/scrapers/rumble/)[### Facebook

20 endpoints](https://scrapier.io/scrapers/facebook/)[### Reddit

9 endpoints](https://scrapier.io/scrapers/reddit/)[### X (Twitter)

6 endpoints](https://scrapier.io/scrapers/x-twitter/)

Get started

## Start pulling YouTube data in 60 seconds

Free API key. No sales call, no proxy setup, and failed calls are free.

[Get your API key →](https://app.scrapier.io/sign-up)[Browse all 21 endpoints](#endpoints)

---
Canonical page: https://scrapier.io/scrapers/youtube/
Site index for AI agents: https://scrapier.io/llms.txt
