# YouTube video scraper API — $0.005 per video

> YouTube video scraper API: full metadata per video id — exact views and likes, length. $0.005 per delivered video, nothing delivered means nothing charged.

[Home](https://quanticdata.io/) / [Collectors](https://quanticdata.io/collectors/) / YouTube video data API

[All collectors](https://quanticdata.io/collectors/)

# YouTube video scraper API

Social & communities · v1.1.1 · `youtube_video`

$0.005 / video

$5.00 / 1K · pay per delivered video

A YouTube video data API that returns one row per video from the watch page itself: title, channel with its id and URL, the exact view and like counts, length in seconds, publish and upload dates, category, keywords, description, thumbnail, the live flag and which caption languages the video carries. Pass video ids or watch, Shorts or youtu.be URLs — up to twenty at a time.

By [Aldo Morese](https://quanticdata.io/about/), founder of QuanticData · Published Aug 21, 2026 · Updated Sep 7, 2026

[Run in dashboard](https://app.quanticdata.io/register?next=%2Fdata-api%2Fcollectors%2Fyoutube_video&utm_source=collector-page&utm_medium=ai-twin&utm_campaign=data-api&utm_content=youtube-video-data-api-hero) · [See the request](https://quanticdata.io/collectors/youtube-video-data-api/#integration)

$0.005 per delivered video · $2 free every month · Failed runs never billed

On this page:

- [Try it](https://quanticdata.io/collectors/youtube-video-data-api/#try)
- [What it is](https://quanticdata.io/collectors/youtube-video-data-api/#what)
- [Limits](https://quanticdata.io/collectors/youtube-video-data-api/#caps)
- [Output fields](https://quanticdata.io/collectors/youtube-video-data-api/#output)
- [Inputs](https://quanticdata.io/collectors/youtube-video-data-api/#input)
- [Pricing](https://quanticdata.io/collectors/youtube-video-data-api/#pricing)
- [Integration](https://quanticdata.io/collectors/youtube-video-data-api/#integration)
- [Use cases](https://quanticdata.io/collectors/youtube-video-data-api/#use-cases)
- [Versus the alternatives](https://quanticdata.io/collectors/youtube-video-data-api/#compare)
- [FAQ](https://quanticdata.io/collectors/youtube-video-data-api/#faq)

What it does

## What a YouTube video data API does

The public watch page shows you "1.2M views"; the number underneath it is exact, and so is the like count. This collector reads the player payload the page ships with and returns those exact integers, along with the channel id, the category, the keyword tags and the list of caption languages — the structured record most people reach for the YouTube Data API to get.

The difference is the quota. The Data API meters every call against a daily unit budget that a few thousand videos will exhaust; this reads the page directly, so there is no key to register and no quota to ration — you size a run by how many videos you pass, not by how many units you have left. Videos that are private or removed come back under `failed` and are never billed.

## Inputs

The whole request. Anything you leave out falls back to the default shown in the catalog.

| Input | Type | Required | What it does |
| --- | --- | --- | --- |
| `videos` | array | yes | Video ids or watch/shorts/youtu.be URLs. |
| `country` | string | no | ISO 3166-1 alpha-2 code — proxy exit geo and Google locale (gl). Omit for the default pool. |
| `max_results` | integer | no | How many videos to deliver at most (1–20). You pay only for delivered videos. |

Outputs — 31 fields, one row per video

## What one video looks like

Every delivered video carries these fields. Nullable means the source did not publish it — the field stays empty instead of being guessed.

| Field | Type | What it holds |
| --- | --- | --- |
| `video_id` | string | 11-char video id. |
| `url` | string | Canonical watch URL. |
| `title` | string | Video title. |
| `channel` | string · nullable | Channel name. |
| `channel_id` | string · nullable | Channel id (UC…). |
| `channel_url` | string · nullable | Channel URL. |
| `views` | integer · nullable | Exact view count. |
| `likes` | integer · nullable | Exact like count (when public). |
| `length_seconds` | integer · nullable | Duration in seconds. |
| `publish_date` | string · nullable | Publish date. |
| `upload_date` | string · nullable | Upload date. |
| `category` | string · nullable | YouTube category. |
| `keywords` | string[] | Video keywords/tags. |
| `description` | string · nullable | Description (first 1500 chars). |
| `thumbnail` | string · nullable | Largest thumbnail URL. |
| `is_live` | boolean | Live content flag. |
| `family_safe` | boolean | Family-safe flag. |
| `captions_available` | boolean | Whether captions exist. |
| `caption_languages` | string[] | Caption language codes. |
| `rank` | integer | 1-based delivery order. |
| `description_full` | string · nullable | Description with line breaks kept (up to 5 000 chars). |
| `hashtags` | string[] | Hashtags used in the description. |
| `channel_subscribers` | integer · nullable | Channel subscribers (4.55M → 4550000). |
| `is_short` | boolean | Eligible as a Short. |
| `is_unlisted` | boolean | Unlisted video. |
| `is_private` | boolean | Private video. |
| `allow_ratings` | boolean | Likes enabled. |
| `live_started_at` | string · nullable | Live broadcast start (ISO 8601). |
| `live_ended_at` | string · nullable | Live broadcast end (ISO 8601). |
| `embed_url` | string · nullable | Embed player URL. |
| `available_countries` | integer · nullable | Number of countries where the video is available. |

Integration

## One POST, typed rows

Base URL `https://api.quanticdata.io/v1`, Bearer auth, the same key as every other Data API. Endpoint: `POST /v1/scraper/collectors/youtube_video/run`.

cURL:

```bash
curl -X POST https://api.quanticdata.io/v1/scraper/collectors/youtube_video/run \
  -H "Authorization: Bearer $QD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"videos":["dQw4w9WgXcQ"],"max_results":1}'
```

Python:

```python
import requests

r = requests.post(
    "https://api.quanticdata.io/v1/scraper/collectors/youtube_video/run",
    headers={"Authorization": f"Bearer {QD_API_KEY}"},
    json={
        "videos": [
            "dQw4w9WgXcQ"
        ],
        "max_results": 1
    },
    timeout=120,
)
for row in r.json()["payload"]["results"]:
    print(row)
```

Node.js:

```javascript
const res = await fetch(
  "https://api.quanticdata.io/v1/scraper/collectors/youtube_video/run",
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.QD_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({"videos":["dQw4w9WgXcQ"],"max_results":1}),
  },
);
const { payload } = await res.json();
console.table(payload.results);
```

MCP:

```bash
claude mcp add quanticdata \
  -e QUANTICDATA_API_KEY=qd_live_your_key_here \
  -- npx -y quanticdata-mcp

# then, in the chat:
> run the youtube_video collector with videos=["dQw4w9WgXcQ"] and max_results=1
```

Example response

POST /v1/scraper/collectors/youtube_video/run

```bash
$ curl $QD/youtube_video/run \
    -H "Authorization: Bearer $QD_API_KEY" \
    -d '{"videos": ["dQw4w9WgXcQ"], "max_results": 1}'
{ "status": "done", "count": 1,
  "results": [
    {
      "video_id": "…",
      "url": "…",
      "title": "…",
      "channel": "…" } ],
  "cost": 0.005 }
# 1 video × $0.005 · nothing delivered, nothing charged
```

Price

## Limits, in plain numbers

Everything that bounds one run of this collector. No hidden throttles.

Max per run

20 videos

Price

$0.005 / video

Per 1,000

$5.00

Failed runs

Free zero rows, zero charge

Free every month

$2 no card

Rate limit

20 req/min on the free tier

Changelog

- `v1.1.1` 2026-10-11
- `v1.1.0` 2026-10-04
- `v1.0.0` 2026-08-18 Initial release

Every run records the collector version it ran on. Breaking output changes bump the major version.

Try it

## YouTube video details, running now

Change the input and run it against the live collector — nothing to install, no sign-up.

Run it from your own code, on your own inputs

Same collector, same rows — $2 of free API credit every month, no card.

[Get my free API key](https://app.quanticdata.io/register?next=%2Fdata-api%2Fcollectors%2Fyoutube_video&utm_source=collector-page&utm_medium=ai-twin&utm_campaign=data-api&utm_content=youtube-video-data-api-closing)

![YouTube video data API: from videos, QuanticData reads the YouTube video page and returns one row per video with title, channel and views, at $0.005 per delivered video.](https://quanticdata.io/collectors/youtube-video-data-api/diagram.webp?v=20261004f)

*You send videos and country; the run goes out through a residential exit and comes back as videos with video_id, title and channel — 31 fields on every row — and you are billed $0.005 for each video actually delivered, nothing for a run that delivers none.*

**$0.005 / video** · 400 videos on the free $2 every month

**Semantic input** · videos, country, max_results — no URL lists

**Up to 20** videos per run, pagination handled for you

**No browser** · read over HTTP/TLS — cheaper and faster than rendering

Pricing

## YouTube video data API pricing

$0.005 per delivered video. A run that delivers nothing costs nothing: blocked pages, challenges and retries are on us, and the $2 monthly allowance covers about 400 videos before you spend anything.

**$0.005** per delivered video · *$5 per 1,000 delivered videos*

**400 videos** · on the free allowance · *$2 every month, no card*

**Zero rows** · zero charge · *blocks, captchas and retries are on us*

**−30%** on volume tiers · *the catalog returns your key's price*

- [Pay as you go](https://app.quanticdata.io/register?next=%2Fdata-api%2Fcollectors%2Fyoutube_video&utm_source=collector-page&utm_medium=ai-twin&utm_campaign=data-api&utm_content=youtube-video-data-api-tier-1): $0/mo · $2 free credit / month · 20 requests / min (300 on real balance) · List unit prices
- [Starter](https://app.quanticdata.io/register?next=%2Fdata-api%2Fcollectors%2Fyoutube_video&utm_source=collector-page&utm_medium=ai-twin&utm_campaign=data-api&utm_content=youtube-video-data-api-tier-2): $19/mo · $15 free credit / month · 300 requests / min · 10% off unit prices
- [Growth](https://app.quanticdata.io/register?next=%2Fdata-api%2Fcollectors%2Fyoutube_video&utm_source=collector-page&utm_medium=ai-twin&utm_campaign=data-api&utm_content=youtube-video-data-api-tier-3): Most popular · $79/mo · $50 free credit / month · 600 requests / min · 20% off unit prices
- [Scale](https://app.quanticdata.io/register?next=%2Fdata-api%2Fcollectors%2Fyoutube_video&utm_source=collector-page&utm_medium=ai-twin&utm_campaign=data-api&utm_content=youtube-video-data-api-tier-4): $299/mo · $250 free credit / month · 1,200 requests / min · 30% off unit prices

Same wallet, same key and same $2 monthly allowance as every other [Data API](https://quanticdata.io/web-data-api-for-ai/). Prices are launch pricing read live from the billing config — `GET /v1/scraper/collectors` returns the price your key actually pays.

## What people build with the YouTube video data API

Three shapes of work this endpoint was designed around.

### Creator and competitor analytics

Pull exact views and likes for a set of videos on a schedule and you have the real engagement curve, not the rounded figure the page prints, for every title you track.

### Content metadata enrichment

Resolve a list of video ids to title, channel, category, length and keyword tags in one pass, filling the columns a media dataset needs without a per-video visit.

### Caption-language discovery

Read which caption languages each video declares to find what is already subtitled and what is missing, before you commission transcription or localization.

## YouTube video data API versus rolling your own

The differences that actually cost time when you build this in-house.

|  | DIY scraper | This collector |
| --- | --- | --- |
| Quota | Daily Data API unit budget | None — pay per video returned |
| View count | Rounded on the page ("1.2M") | Exact integer from the player payload |
| Auth | API key and a Google project | No key, ids or URLs straight in |

## What people search for

Live autocomplete demand around YouTube video details, pulled with our own Keyword ideas collector.

Searches:

- [youtube video scraper github](https://quanticdata.io/collectors/youtube-video-data-api/#try)
- [youtube video scraper python](https://quanticdata.io/collectors/youtube-video-data-api/#try)
- [youtube video scraping](https://quanticdata.io/collectors/youtube-video-data-api/#try)
- [youtube video transcript scraper](https://quanticdata.io/collectors/youtube-video-data-api/#try)
- [youtube video data scraper](https://quanticdata.io/collectors/youtube-video-data-api/#try)
- [youtube shorts video scraper](https://quanticdata.io/collectors/youtube-video-data-api/#try)
- [youtube video comment scraper](https://quanticdata.io/collectors/youtube-video-data-api/#try)
- [youtube video link scraper](https://quanticdata.io/collectors/youtube-video-data-api/#try)
- [youtube video script scraper](https://quanticdata.io/collectors/youtube-video-data-api/#try)
- [youtube video title scraper](https://quanticdata.io/collectors/youtube-video-data-api/#try)
- [ai youtube video scraper](https://quanticdata.io/collectors/youtube-video-data-api/#try)
- [apify youtube video scraper](https://quanticdata.io/collectors/youtube-video-data-api/#try)
- [youtube video text scraper](https://quanticdata.io/collectors/youtube-video-data-api/#try)
- [youtube video metadata scraper](https://quanticdata.io/collectors/youtube-video-data-api/#try)
- [youtube shorts and video scraper](https://quanticdata.io/collectors/youtube-video-data-api/#try)
- [how to scrape youtube videos](https://quanticdata.io/collectors/youtube-video-data-api/#try)

![YouTube video data API: the POST to the youtube_video collector, 1 video delivered and the bill, 1 × $0.005 = $0.005 in usage.cost_usd; zero videos would cost $0.](https://quanticdata.io/collectors/youtube-video-data-api/diagram2.webp?v=20261004f)

*The same call you would paste into a terminal: a Bearer key, videos and country in the body, and back the envelope every QuanticData endpoint returns — type, message, payload — where count is how many videos arrived and usage.cost_usd is $0.005, which is 1 × $0.005. A run that delivers nothing costs nothing. The key is good for 20 req/min on the free tier.*

## Sources and standards

The platform documentation and standards this collector is built against — check any claim on this page against the primary source:

- [Google: YouTube Data API v3, the videos resource](https://developers.google.com/youtube/v3/docs/videos)
- [Schema.org: the VideoObject type](https://schema.org/VideoObject)

## FAQ

Questions we get about the YouTube video data API.

[Something else? Ask us](https://quanticdata.io/collectors/youtube-video-data-api/#ask)

### How is this different from the YouTube Data API?

It returns much of the same per-video record — title, channel, exact views and likes, length, category, keywords, captions — but reads it from the watch page's player payload instead of the API. So there is no API key and no daily unit quota to manage; a large batch is a question of how many ids you send, not how much quota is left.

### Are the view and like counts exact?

Yes. The visible page rounds to "1.2M", but the payload behind it carries the precise numbers, and that is what lands in `views` and `likes` — the like count whenever the creator keeps it public.

### Do I get the transcript or just the languages?

Just the caption *languages* the video declares, in `caption_languages`, plus a `captions_available` flag. The collector reports which subtitle tracks exist; it does not return the transcript text itself.

### Can I pass full URLs, or only video ids?

Either. It accepts bare eleven-character ids and watch, Shorts and youtu.be URLs, up to twenty per run, and normalizes them to the canonical watch URL on the way out.

### Is there a free YouTube video data API?

Every account gets $2 of credit every month with no card, which is about 400 delivered videos on this endpoint at $0.005 each. It renews monthly, and a run that delivers nothing is never billed — so a failed or blocked attempt does not eat the allowance.

### How much does one run cost?

Multiply the rows you actually receive by $0.005. A run capped at 20 videos — the maximum for this collector — costs $0.1 if every row comes back, and less when the source has fewer. Volume tiers take up to 30% off, and `GET /v1/scraper/collectors` returns the price your key actually pays.

## Run the YouTube video data API now

$2 of free credit every month, no card. Your key returns its own prices from `GET /v1/scraper/collectors`.

[Run in dashboard](https://app.quanticdata.io/register?next=%2Fdata-api%2Fcollectors%2Fyoutube_video&utm_source=collector-page&utm_medium=ai-twin&utm_campaign=data-api&utm_content=youtube-video-data-api-cta-3)

![Illustration: three coloured zones of the page that is read (YouTube video page) turn into clean JSON with the fields title, channel and views; 31 fields on every row.](https://quanticdata.io/collectors/youtube-video-data-api/hero.webp?v=20261004h)

Related:

- [All 100+ collectors](https://quanticdata.io/collectors/)
- [YouTube scraper API](https://quanticdata.io/collectors/youtube-scraper-api/)
- [YouTube channel scraper API](https://quanticdata.io/collectors/youtube-channel-scraper-api/)
- [Video search API](https://quanticdata.io/collectors/search-videos-api/)
- [GitHub repository search API](https://quanticdata.io/collectors/github-repository-search-api/)
- [Hacker News API](https://quanticdata.io/collectors/hacker-news-api/)
- [YouTube transcript scraper](https://quanticdata.io/collectors/youtube-transcript-scraper/)
- [YouTube comments scraper](https://quanticdata.io/collectors/youtube-comments-scraper/)
- [Documentation](https://quanticdata.io/docs/)

In code:

- [YouTube video data API in Python](https://quanticdata.io/collectors/youtube-video-data-api/python/)

---

Source: https://quanticdata.io/collectors/youtube-video-data-api/ · Site index for AI: https://quanticdata.io/llms.txt
