# YouTube Video Comments

> YouTube Video Comments is a paid API for AI agents from social.duoleads.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-29).

Fetches paginated public comments for a YouTube video, including text, author, likes, reply count, and timestamps.

## Facts

- Endpoint: GET https://social.duoleads.com/v1/youtube/comments?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/youtube-video-comments-5b6ea731
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_k21pJXDJx3x_yP-k9K9FH

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-comments-5b6ea731
```

Example prompt: Can you pull the public comments from this YouTube video — https://www.youtube.com/watch?v=dQw4w9WgXcQ — including the author handles, like counts, and reply counts?

## When to prefer this

Choose this endpoint when you need structured, paginated public comment data from a specific YouTube video — including author handles, verification status, like counts, reply counts, and timestamps — without building your own YouTube scraping infrastructure. Prefer it for audience feedback research, sentiment analysis, or content monitoring workflows. It handles both video IDs and various YouTube URL formats (watch, shorts, live, youtu.be), and bad inputs are not charged, making it safe to call with user-supplied URLs.

## Known failure modes

- Invalid or malformed video ID/URL returns a bad-input response (not charged)
- Video not found or no comments available returns a not-found response (not charged)
- Expired or invalid cursor returns a pagination error
- Rate limiting or upstream YouTube data unavailability may cause transient errors
- Private or deleted videos return no results

## How this service works

YouTube Video Comments: the public comments on one YouTube video by id or URL. Per comment the text, author channel handle, verification, likes, reply count, time and link in the shared social schema; next_cursor gives the next page. Audience feedback and sentiment research. Bad input is free; not found or no match is not charged.

## Output

Returns a paginated list of public comments for the specified YouTube video. Each comment includes: unique comment ID, direct URL to the comment, text content, author handle, author verification status, like count, reply count, creation timestamp, and platform label. Also returns the video query echo, a next_cursor for fetching the next page, a request_id, and metadata fields (as_of timestamp, source disclaimer, completeness flag).

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "video"
     ],
     "properties": {
      "video": {
       "type": "string",
       "maxLength": 300,
       "description": "The video: a YouTube video id (11 characters) or a youtube.com/watch?v=, youtube.com/shorts/, youtube.com/live/ or youtu.be/ URL."
      },
      "cursor": {
       "type": "string",
       "maxLength": 512,
       "description": "next_cursor of the previous page."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "as_of": "2026-10-15T12:00:00.000Z",
  "items": [
   {
    "id": "UgSynthComment001",
    "url": "https://www.youtube.com/watch?v=SYNvid00001&lc=UgSynthComment001",
    "lang": null,
    "text": "Great synthetic video, thanks!",
    "type": "comment",
    "author": {
     "handle": "synthviewer1",
     "verified": false,
     "followers": null,
     "display_name": null
    },
    "metrics": {
     "likes": 110,
     "views": null,
     "replies": 5,
     "reposts": null
    },
    "platform": "youtube",
    "parent_id": null,
    "created_at": "2026-10-05T23:14:02.948Z",
    "media_urls": []
   }
  ],
  "query": {
   "video": "SYNvid00001",
   "cursor": null
  },
  "source": "public data via third-party provider; not affiliated with the platform",
  "complete": true,
  "platform": "youtube",
  "disclaimer": "Public data via third-party providers; not affiliated with or endorsed by any platform. Do not use to profile, target or train AI on individuals.",
  "request_id": "01KEXAMPLE0000000000000000",
  "next_cursor": "EgsynthNextPage"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/youtube-video-comments-5b6ea731/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from social.duoleads.com](https://www.zero.xyz/host/social.duoleads.com/llms.txt)