# YouTube Comments Scraper (x402)

> YouTube Comments Scraper (x402) 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).

Extracts structured comment data (including replies) from one or more public YouTube videos, billed per successful call via x402 micropayment.

## Facts

- Endpoint: POST https://x402.186-241-26-229.sslip.io/v1/youtube-comments?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-comments-scraper-x402-a2fcd352
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-ukpWLQzeBT1QK9psDBdb

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-comments-scraper-x402-a2fcd352 -d '<json body>'
```

Example prompt: Grab the 200 newest comments (including replies) from this YouTube video https://www.youtube.com/watch?v=dQw4w9WgXcQ and give me each commenter's name, comment text, and channel link.

## When to prefer this

Choose this endpoint when you need structured, machine-readable comment data from specific YouTube videos without building or maintaining your own scraper. It is especially well-suited for agent workflows that require pay-per-use pricing (no subscription), tolerance for failed runs at no cost, and support for replies alongside top-level comments. Prefer it over generic web scrapers when you need YouTube-specific output fields like channel IDs and verified status.

## Known failure modes

- Video is private or age-restricted — returns empty result, no charge
- Invalid or malformed YouTube URL — request rejected
- Video has comments disabled — returns empty result, no charge
- Rate limiting or YouTube anti-bot measures — may return partial or empty result
- Network timeout on large comment sets — partial result possible

## 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 retrieved items and an array of comment records. Each record includes the comment ID, text body, author display name, comment permalink URL, author avatar image URL, author channel ID, author channel URL, and a boolean indicating whether the author is verified. Failed or empty scrape runs are not billed.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "maxItems": {
   "type": "integer",
   "default": 0,
   "minimum": 0,
   "description": "Hard cap across all videos. Zero means no total cap."
  },
  "startUrls": {
   "type": "array",
   "description": "Public YouTube video URLs. Watch, Shorts, live, embedded, and short links are accepted."
  },
  "maxComments": {
   "type": "integer",
   "default": 100,
   "minimum": 1,
   "description": "Stop after this many comments and replies per video."
  },
  "includeReplies": {
   "type": "boolean",
   "default": true,
   "description": "Follow public reply threads as well as top-level comments."
  },
  "sortCommentsBy": {
   "enum": [
    "TOP_COMMENTS",
    "NEWEST_FIRST"
   ],
   "type": "string",
   "default": "NEWEST_FIRST",
   "description": "Order top-level comments by featured ranking or newest first."
  },
  "oldestCommentDate": {
   "type": "string",
   "description": "Optional UTC date such as 2026-09-01 or relative age such as 7 days. YouTube supplies relative times, so this filter is approximate and selects newest-first order."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "cid": null,
    "author": null,
    "comment": null,
    "commentUrl": null,
    "authorAvatarUrl": null,
    "authorChannelId": null,
    "authorChannelUrl": null,
    "authorIsVerified": null
   }
  ],
  "product": "youtube-comments"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/youtube-comments-scraper-x402-a2fcd352/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)