# YouTube Video & Channel Data Scraper

> YouTube Video & Channel Data Scraper is a paid API for AI agents from api.scrapeforagents.tech, paid per call via x402, $0.025/call, status unknown (last checked 2026-10-02).

Scrapes structured video metadata from YouTube URLs, channels, playlists, Shorts, or search queries, returning titles, IDs, channel info, thumbnails, and optional detailed stats.

## Facts

- Endpoint: POST https://api.scrapeforagents.tech/v1/youtube?utm_source=zero.xyz
- Price: $0.025/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/youtube-video-channel-data-scraper-3818938d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_5DC3hVfvvX7BeWA-7ovel

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability youtube-video-channel-data-scraper-3818938d -d '<json body>'
```

Example prompt: Search YouTube for 'machine learning tutorials 2024' and grab up to 50 video results including full details like view counts, likes, subscriber counts, and exact publish dates for each one.

## When to prefer this

Choose this endpoint when you need structured YouTube data — video metadata, channel catalogs, playlist contents, or search results — without managing YouTube API quotas or credentials. It is especially useful for bulk collection across multiple sources in a single call, or when you need extended details like subscriber counts and exact publish dates that the official YouTube Data API limits. The pay-per-call model with no charge for failed/empty runs makes it safe for exploratory queries.

## Known failure modes

- Invalid or private YouTube URL returns empty items array (not charged)
- Search term yields no results — returns count 0 and empty items (not charged)
- Rate limiting or YouTube blocking may result in partial results
- Very large channels or playlists may be capped by maxItems before all videos are collected
- includeVideoDetails mode is significantly slower and may time out on large inputs

## How this service works

Pay-per-call structured web data. Failed or empty runs are not charged.

## Output

Returns a JSON object with a count of results and an array of video items, each containing video ID, URL, title, channel ID, channel name, channel URL, and thumbnail URL. When includeVideoDetails is enabled, also includes the full description, exact publication date, current view count, like count when available, comment count, and channel subscriber count.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "maxItems": {
   "type": "integer",
   "default": 100,
   "minimum": 0,
   "description": "Hard cap across all sources. Zero has no total cap."
  },
  "startUrls": {
   "type": "array",
   "default": [],
   "description": "Public video, channel, playlist, Shorts, or search result URLs. Both URLs and search terms are processed."
  },
  "maxResults": {
   "type": "integer",
   "default": 50,
   "minimum": 0,
   "description": "Maximum videos per search term, channel, playlist, or search URL. Zero collects available results up to the page safety limit."
  },
  "searchQueries": {
   "type": "array",
   "description": "Search YouTube for each term and collect video results."
  },
  "includeVideoDetails": {
   "type": "boolean",
   "default": false,
   "description": "Visit each video page for its full description, exact publication date, current views, likes when available, comments count, and subscriber count. Slower than listing-only mode."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "id": null,
    "url": null,
    "title": null,
    "channelId": null,
    "fromYTUrl": null,
    "channelUrl": null,
    "channelName": null,
    "thumbnailUrl": null
   }
  ],
  "product": "youtube"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/youtube-video-channel-data-scraper-3818938d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.scrapeforagents.tech](https://www.zero.xyz/host/api.scrapeforagents.tech/llms.txt)