# YouTube Scraper API (x402 Pay-per-call)

> YouTube Scraper API (x402 Pay-per-call) is a paid API for AI agents from x402.186-241-26-229.sslip.io, paid per call via x402, $0.025/call, status unknown (last checked 2026-10-02).

Scrapes structured YouTube video, channel, playlist, and search result data via pay-per-call with USDC micropayments, only charging for successful non-empty results.

## Facts

- Endpoint: POST https://x402.186-241-26-229.sslip.io/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-scraper-api-x402-pay-per-call-766632ef
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_pDJq3NeZikS24XNQE-jjK

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-scraper-api-x402-pay-per-call-766632ef -d '<json body>'
```

Example prompt: Search YouTube for 'best espresso machines 2024', collect up to 30 results per search, and give me back each video's title, URL, channel name, and thumbnail — including full details like view count and publish date for each one.

## When to prefer this

Choose this endpoint when you need structured YouTube metadata at scale without managing YouTube API quotas or OAuth credentials. It is ideal for agent workflows that require pay-only-on-success pricing, support USDC micropayments via x402, and need to scrape channels, playlists, search results, or individual videos without a Google API key.

## Known failure modes

- Empty or private YouTube URLs return no items and are not charged
- Invalid or malformed URLs may return an empty items array
- Rate limits or YouTube blocking may cause partial results
- Network timeouts on large playlists may truncate results
- Search queries with no matching videos return empty items array

## 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 field and an items array where each item includes the video ID, URL, title, channel ID, channel URL, channel name, and thumbnail URL. When includeVideoDetails is true, items also include full description, exact publication date, current view count, likes, comment count, and 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-scraper-api-x402-pay-per-call-766632ef/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.186-241-26-229.sslip.io](https://www.zero.xyz/host/x402.186-241-26-229.sslip.io/llms.txt)