# YouTube API

> The YouTube API by everydata.io returns live YouTube data (videos, channels, comments, playlists, trending) as structured JSON: 18 endpoints under /ytb, one API key, 100 free requests a month.

- URL: https://everydata.io/apis/youtube
- Updated: 2026-10-05
- Publisher: everydata.io (https://everydata.io)

The everydata.io YouTube scraper API reads public YouTube pages when you call it: search videos, or send a video or channel link and get details, comments, related videos, channel videos, playlists and trending lists back as JSON – with an API key and without the OAuth quotas of the YouTube Data API.

Search videos, read video and channel details, comments, related content, playlists, community posts and trending lists – without OAuth quotas.

## Key facts

- Status: live
- Endpoints: 18 (path prefix `/ytb`)
- Quota: A call to the YouTube API counts as 1 request against the monthly quota.
- Pricing: 100 free requests a month; paid plans from €30 a month for 5,000 requests (€1.00–€6.00 per 1,000 requests). One quota is shared across all 34 platforms; failed requests (5xx, blocked pages) are not counted.
- Measured average response time (last 24 h): 2.6 s, success rate 100% – live figures at https://everydata.io/status
- Authentication: `x-api-key` header

## Endpoints

- `GET /ytb/youtube-search-videos` – Search Videos. Search YouTube videos by query. Params: `query`, `languageCode`?, `countryCode`?, `cursor`?.
- `GET /ytb/youtube-auto-complete` – Auto Complete. Search suggestions for a query. Params: `query`, `languageCode`?, `countryCode`?.
- `GET /ytb/youtube-video-details` – Video Details. Video details (title, description, channel, view/like counts, publish date, keywords, thumbnails) for a video ID or URL. Params: `id`, `languageCode`?, `countryCode`?.
- `GET /ytb/youtube-video-comments` – Video Comments. Comments of a video, paginated via `cursor`. Params: `id`, `cursor`?, `languageCode`?, `countryCode`?.
- `GET /ytb/youtube-video-related-contents` – Video Related Contents. Related videos of a video, paginated via `cursor`. Params: `id`, `cursor`?, `languageCode`?, `countryCode`?.
- `GET /ytb/youtube-video-streaming-data` – Video Streaming Data. Streaming data (formats, adaptive formats, expiry) for a video. Params: `id`.
- `GET /ytb/youtube-channel-details` – Channel Details. Channel details (title, description, subscriber/video counts, avatar, banner, links) for a channel ID, handle or URL. Params: `id`, `languageCode`?, `countryCode`?.
- `GET /ytb/youtube-channel-videos` – Channel Videos. Videos of a channel; `filter` selects videos, streams, shorts or live now. Params: `id`, `filter`?, `cursor`?, `languageCode`?, `countryCode`?.
- `GET /ytb/youtube-channel-playlists` – Channel Playlists. Playlists of a channel; `filter` selects the playlist listing. Params: `id`, `filter`?, `cursor`?, `languageCode`?, `countryCode`?.
- `GET /ytb/youtube-channel-collections` – Channel Collections. Channels featured by a channel (collections / subscriptions). Params: `id`, `filter`?, `cursor`?, `languageCode`?, `countryCode`?.
- `GET /ytb/youtube-channel-community` – Channel Community. Community posts of a channel, paginated via `cursor`. Params: `id`, `cursor`?.
- `GET /ytb/youtube-channel-search` – Channel Search. Search within a channel. Params: `id`, `query`, `cursor`?, `languageCode`?, `countryCode`?.
- `GET /ytb/youtube-community-post-details` – Community Post Details. Details of a community post including its `commentsCursor`. Params: `id`.
- `GET /ytb/youtube-community-post-comments` – Community Post Comments. Comments of a community post; pass the `commentsCursor` from Community Post Details. Params: `cursor`.
- `GET /ytb/youtube-playlist-details` – Playlist Details. Playlist details (title, owner, video count, views). Params: `id`, `languageCode`?, `countryCode`?.
- `GET /ytb/youtube-playlist-videos` – Playlist Videos. Videos of a playlist, paginated via `cursor`. Params: `id`, `cursor`?, `languageCode`?, `countryCode`?.
- `GET /ytb/youtube-home` – Home. The YouTube home feed for a language/country, paginated via `cursor`. Params: `cursor`?, `languageCode`?, `countryCode`?.
- `GET /ytb/youtube-trending-videos` – Trending Videos. Trending videos for a country. Params: `countryCode`?.

## Example

```bash
curl -s "https://api.everydata.io/ytb/youtube-video-details?id=kJQP7kiw5Fk" \
  -H "x-api-key: YOUR_API_KEY"
```

```json
{
  "responseStatus": "PAGE_FOUND",
  "responseMessage": "Page successfully found!",
  "videoId": "kJQP7kiw5Fk",
  "title": "Luis Fonsi - Despacito ft. Daddy Yankee",
  "channelId": "UCLp8RBhQHu9wSsq62j_Md6A",
  "channelName": "LuisFonsiVEVO",
  "viewCount": 9125159593,
  "likeCount": 56673581,
  "commentCount": 4300000,
  "publishedAt": "2017-01-12T21:00:02-08:00",
  "duration": 282,
  "category": "Music"
}
```

## Use cases

- Influencer analytics
- Content monitoring
- Trend detection
- Comment mining

## FAQ

### Is there an official YouTube API?

Yes: the YouTube Data API v3 needs a Google Cloud project and counts quota units – 10,000 a day by default, and one search costs 100. everydata.io is an independent service, not affiliated with YouTube or Google: it reads public YouTube pages at request time and returns them as JSON, with only an everydata.io API key and the quota of your everydata.io plan.

### What data does the YouTube API return?

Videos, channels, comments, playlists, trending. The API has 18 endpoints under the /ytb path – search videos, video details, video comments, related videos, channel details, channel videos, channel playlists, playlist videos and trending – and every response is structured JSON that starts with responseStatus and responseMessage.

### How much does the YouTube API cost?

A call to the YouTube API counts as 1 request against the monthly quota. The YouTube API is included in every plan and shares one quota with all other platforms: 100 free requests a month; paid plans from €30 a month for 5,000 requests (€1.00–€6.00 per 1,000 requests). Failed requests (5xx, blocked pages) are not counted.

### Is the YouTube data realtime?

Yes. Each request loads the live YouTube page when you call the API – there is no database of old snapshots in between.

### Do I need a YouTube account or an official YouTube API key?

No. You only need an everydata.io API key, sent in the x-api-key header. The free plan works without a credit card.

### Is this a YouTube scraper?

It replaces one. everydata.io loads the live YouTube pages for you and returns parsed JSON fields, so you do not build or maintain a YouTube scraper, parser or proxy setup yourself. Retries are included, and a request that still fails costs no quota.

### What happens when YouTube blocks a request?

The API retries the fetch automatically. If the page still cannot be loaded you get a 502 or 503 error, and that request costs no quota. Success rates and response times per platform are measured around the clock on the status page.

### Can ChatGPT, Claude or an AI agent use the YouTube API?

Yes. Connect the hosted everydata.io MCP server and the assistant can call every YouTube endpoint as a tool, or register the plain HTTPS endpoints as functions in any agent framework. The endpoint list is also in /llms.txt and the OpenAPI spec.

## More

- [All platforms](https://everydata.io/apis) · [Pricing](https://everydata.io/pricing) · [API reference](https://everydata.io/docs) · [Getting started](https://everydata.io/docs/getting-started) · [MCP server](https://everydata.io/docs/mcp) · [Status](https://everydata.io/status)
- Machine-readable: [llms.txt](https://everydata.io/llms.txt), [llms-full.txt](https://everydata.io/llms-full.txt), [OpenAPI](https://api.everydata.io/openapi.json)
