# API Direct – YouTube Video Comments

> API Direct – YouTube Video Comments is a paid API for AI agents from x402.apidirect.io, paid per call via x402, $0.006/call, status unknown (last checked 2026-10-30).

Fetches comment threads from a YouTube video by URL or video ID, with optional pagination and sort order.

## Facts

- Endpoint: GET https://x402.apidirect.io/v1/youtube/comments?utm_source=zero.xyz
- Price: $0.006/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-direct-youtube-video-comments-8c3fb99f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_JywHcKMF86mVJNc2QeHTq

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 api-direct-youtube-video-comments-8c3fb99f
```

Example prompt: Grab the top 200 comments (2 pages, sorted by relevance) from this YouTube video: https://www.youtube.com/watch?v=dQw4w9WgXcQ so I can see what viewers are saying.

## When to prefer this

Use this endpoint when you need to programmatically retrieve YouTube video comments at scale without YouTube Data API quotas or credentials. Ideal for sentiment analysis, audience research, competitive intelligence, or content monitoring pipelines. Choose this over manual scraping when you need structured comment data quickly with configurable pagination and sort order.

## Known failure modes

- Invalid or unrecognized YouTube URL/video ID returns an error
- Video has comments disabled returns empty or error response
- Private or deleted video returns an access error
- Pages parameter out of range (outside 1-20) causes validation failure
- Network or rate-limit issues from upstream YouTube may cause partial or failed responses

## How this service works

Get comments (comment threads) from a YouTube video.

## Output

Returns one or more pages of YouTube comment threads for the specified video, each page containing up to ~100 comments with text, author, and metadata. Multiple pages are merged into a single response. Billed per page fetched.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "url"
     ],
     "properties": {
      "url": {
       "type": "string",
       "maxLength": 500,
       "description": "YouTube video URL (watch?v=, youtu.be/, /shorts/, /embed/, /live/ or /v/ forms) or 11-character video ID"
      },
      "pages": {
       "type": "integer",
       "default": 1,
       "maximum": 20,
       "minimum": 1,
       "description": "Number of pages to fetch and merge (1-20). Each page returns up to ~100 comments. Billed per page."
      },
      "sort_by": {
       "enum": [
        "most_recent",
        "relevance"
       ],
       "type": "string",
       "default": "relevance",
       "description": "Sort order"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-direct-youtube-video-comments-8c3fb99f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.apidirect.io](https://www.zero.xyz/host/x402.apidirect.io/llms.txt)