# YouTube data API for AI agents: from $0.001 per call ($1 per 1,000), no subscription

> Whizbrew's YouTube data API costs from $0.001 per call ($1 per 1,000 calls); a typical call is $0.002 ($2 per 1,000). Only a call that returns data is charged: an empty or failed call is free. There is no subscription and no monthly fee. A new account starts with $2 of free credit, with no card.

It reads YouTube channels, videos, Shorts, comments, transcripts and search: 23 tools, live at the moment of the call, over one API key or one MCP server (`https://whizbrew.com/mcp`). It is an API, not a scraper you run: no proxies, no browser and no scraping code on your side. The same key reaches 893 tools for other platforms ([all APIs](https://whizbrew.com/api), [all tools](https://whizbrew.com/tools?a=b706371213ea), [pricing](https://whizbrew.com/pricing?a=b706371213ea)).

## Pricing

| Tool | What it returns | Per call that returns data | Per 1,000 calls |
|---|---|---|---|
| `youtube.channel` | Public YouTube channel and its counts. | $0.002 | $2 |
| `youtube.videos` | Videos of a YouTube channel: newest first, or most viewed or oldest first with sort. Pass cursor to page through all of them. A video whose date could not be read names the fields it lacks in "missing". | $0.002 | $2 |
| `youtube.video` | One YouTube video or Short: title, description, channel, views, likes, comment count and publish date. duration_s is null when YouTube withholds it; category and keywords are null for music videos. | $0.002 | $2 |
| `youtube.transcript` | Captions of a YouTube video with timestamps. A video without captions answers status "no_captions" at no charge. | $0.003 | $3 |
| `youtube.search` | Search YouTube for videos, Shorts, channels or playlists, or for videos inside one channel. Counts read from rounded text are marked approximate. Shorts come with a rounded view count only; set details for their exact views, likes and publish day. | $0.002 | $2 |
| `youtube.suggest` | Search suggestions YouTube shows for the start of a query. | $0.001 | $1 |
| `youtube.comments` | Comments under a YouTube video: text, author, likes, reply count. Each comment with replies carries a replies_token. | $0.003 | $3 |
| `youtube.comment_replies` | Replies under one YouTube comment (of a video or of a community post), oldest first. | $0.002 | $2 |
| `youtube.shorts` | Recent Shorts of a YouTube channel. The list itself carries only rounded view counts (marked approximate); set details to get exact views, likes and the publish day of each Short. | $0.002 | $2 |
| `youtube.streams` | Live and past live streams of a YouTube channel, newest first. A channel without a Live tab returns an empty list. | $0.002 | $2 |
| `youtube.playlists` | Playlists of a YouTube channel with their video counts. | $0.002 | $2 |
| `youtube.posts` | Recent posts (community tab) of a YouTube channel: text, images, likes. | $0.002 | $2 |
| `youtube.about` | The About panel of a YouTube channel: description, country, join date, total views, video count, links, and email addresses the channel wrote into its own description. | $0.002 | $2 |
| `youtube.related` | The videos YouTube shows next to a video ("up next"): title, channel, duration, rounded views, relative date. | $0.002 | $2 |
| `youtube.playlist` | The videos of a public YouTube playlist, in playlist order: title, channel, duration, rounded views, relative date. | $0.002 | $2 |
| `youtube.shorts_feed` | The Shorts feed YouTube gives a signed-out visitor in the US: what it is pushing right now, not a ranked chart. Every Short has its id, URL and cover; title, channel and counts only where the feed carries them (use youtube.video for the rest). | $0.002 | $2 |
| `youtube.post` | One YouTube community post by URL or id: text, images, likes, channel. | $0.002 | $2 |
| `youtube.post_comments` | Comments under a YouTube community post: text, author, likes, reply count. Each comment with replies carries a replies_token for youtube.comment_replies. | $0.003 | $3 |
| `youtube.charts` | YouTube's public music charts for a country or the world: top music videos, trending music videos, top songs, top artists and the songs most used in Shorts, with rank, previous rank and views. Music only: this is not the general Trending page, which YouTube removed. | $0.002 | $2 |
| `youtube.hashtag` | A YouTube hashtag: how many videos and channels use it (as YouTube rounds them) and the videos its page shows first, with views and channel. | $0.002 | $2 |
| `youtube.chapters` | The chapters of a YouTube video: each chapter's title, start time, link and thumbnail, and whether the uploader wrote them or YouTube made them. An empty list when the video has no chapters. | $0.002 | $2 |
| `youtube.sponsor_segments` | Which parts of a YouTube video are a paid sponsor read, self-promotion, a subscribe reminder, an intro or an outro, as volunteers marked them in SponsorBlock: each segment with start, end, length, votes and whether it is locked, plus the sponsored seconds, their share of the video and whether the video has a sponsor read at all. One read of SponsorBlock's public API (crowd-sourced, CC BY-NC-SA 4.0); YouTube itself is not read, no login. A video nobody marked gives an empty list, which does not prove it has no sponsor. | $0.001 | $1 |
| `youtube.dislikes` | Likes and the ESTIMATED dislikes of a YouTube video, from the Return YouTube Dislike project: likes, estimated dislikes, share of likes, a 1 to 5 rating, views and when the project counted them. YouTube hides the real dislike number since 2021: the figure is this project's estimate from its extension users and archived counts, not YouTube's. One read of the project's public API; YouTube itself is not read, no login. A video the project does not know gives no numbers. | $0.001 | $1 |

## Example calls

`youtube.channel` ($0.002 per call): Public YouTube channel and its counts

```
curl -s -X POST https://whizbrew.com/v1/call/youtube.channel \
  -H "Authorization: Bearer $WHIZBREW_KEY" -H "content-type: application/json" \
  -d '{"handle":"duolingo"}'
```

`youtube.videos` ($0.002 per call): Videos of a YouTube channel: newest first, or most viewed or oldest first with sort

```
curl -s -X POST https://whizbrew.com/v1/call/youtube.videos \
  -H "Authorization: Bearer $WHIZBREW_KEY" -H "content-type: application/json" \
  -d '{"handle":"duolingo","limit":3}'
```

`youtube.video` ($0.002 per call): One YouTube video or Short: title, description, channel, views, likes, comment count and publish date

```
curl -s -X POST https://whizbrew.com/v1/call/youtube.video \
  -H "Authorization: Bearer $WHIZBREW_KEY" -H "content-type: application/json" \
  -d '{"url":"https://www.youtube.com/watch?v=jNQXAC9IVRw"}'
```

Over MCP the same call is `call_tool` with `{"tool": "<name>", "arguments": {…}}`. How often each tool works, measured from real calls: [https://whizbrew.com/status](https://whizbrew.com/status).

## Start

- **An agent on its own**: read [https://whizbrew.com/agents.md?a=b706371213ea](https://whizbrew.com/agents.md?src=body-text&a=b706371213ea). It asks for a free quote (`GET https://whizbrew.com/v1/agent/guide?goal=<the task in plain words>`), then one request (`POST https://whizbrew.com/v1/agent/start?a=b706371213ea`) gives it a key that works at once with the free credit, with no email and no sign-up form. Its human claims the account later.
- **A chat app** (ChatGPT, Claude, Gemini): add the MCP server `https://whizbrew.com/mcp` as a custom connector and sign in. No key to copy.
- **An agent with a shell** (Claude Code, Codex, Cursor): read [https://whizbrew.com/llms.txt?a=b706371213ea](https://whizbrew.com/llms.txt?src=body-text&a=b706371213ea). The agent starts a pairing with one request, its user approves with one click, and the agent holds its own key.
- **Plain HTTP**: create an account at [https://whizbrew.com/app#signup](https://whizbrew.com/app#signup), make a key, then `POST https://whizbrew.com/v1/call/<tool>` with `Authorization: Bearer <key>`.
