# ScrapeMole YouTube Video Details API

> ScrapeMole YouTube Video Details API is a paid API for AI agents from scrapemole-api-mainnet.scrapemole.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-19).

Fetches detailed metadata for a YouTube video by URL or video ID, including title, view/like/comment counts, channel info, publish date, and more

## Facts

- Endpoint: GET https://scrapemole-api-mainnet.scrapemole.workers.dev/v1/youtube/video?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/scrapemole-youtube-video-details-api-fa9df6bf
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_CPiQ9E_bLNU950Hf7hseP

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 scrapemole-youtube-video-details-api-fa9df6bf
```

Example prompt: Can you pull up the details for this YouTube video — how many views, likes, and comments it has, who uploaded it, and when it was published? The video ID is aircAruvnKk.

## When to prefer this

Choose this endpoint when you need rich, structured metadata for a specific YouTube video without setting up API keys or YouTube Data API quotas. Ideal for agents that need pay-per-use pricing with no account setup, especially when pulling occasional video stats, verifying content details, or enriching data pipelines with YouTube metadata. Prefer over YouTube Data API when avoiding OAuth and quota management.

## Known failure modes

- Invalid or non-existent video ID returns an error (not charged)
- Private or deleted videos cannot be scraped
- Payment verification failure blocks the request
- Rate limits or YouTube-side blocks may cause transient errors
- Malformed video URL that cannot be parsed to a valid ID

## How this service works

Pay-per-call public web data for agents: Google Trends, YouTube transcripts, YouTube search, YouTube channel videos, YouTube video details, YouTube comments, YouTube playlists. Pay per successful call in USDC with x402; errors are never charged. No accounts, no API keys.

Payments: x402 v2, scheme "exact", USDC on Base (eip155:8453). The payment is verified before the scrape and settled only when the response is 200. Terms: https://scrapemole-api-mainnet.scrapemole.workers.dev/terms

## Output

A JSON object containing: video URL, title, videoId, isLive flag, category, keywords array, channelId, channelName, channelHandle, likeCount, viewCount, commentCount, publishDate (YYYY-MM-DD), and durationSeconds. Only returned on HTTP 200; failed/errored requests are not charged.

## 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": {
      "lang": {
       "type": "string",
       "examples": [
        "en"
       ],
       "description": "Interface language (hl), e.g. en, de."
      },
      "video": {
       "type": "string",
       "examples": [
        "aircAruvnKk"
       ],
       "description": "YouTube video URL or 11-character video ID."
      },
      "country": {
       "type": "string",
       "examples": [
        "US"
       ],
       "description": "Country (gl), e.g. US, GB."
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "url": "https://www.youtube.com/watch?v=aircAruvnKk",
  "title": "But what is a neural network? | Deep learning chapter 1",
  "isLive": false,
  "videoId": "aircAruvnKk",
  "category": "Education",
  "keywords": [
   "neural networks",
   "deep learning"
  ],
  "channelId": "UCYO_jab_esuFRV4b17AJtAw",
  "likeCount": 400000,
  "viewCount": 21000000,
  "channelName": "3Blue1Brown",
  "publishDate": "2017-10-05",
  "commentCount": 9000,
  "channelHandle": "@3blue1brown",
  "durationSeconds": 1118
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/scrapemole-youtube-video-details-api-fa9df6bf/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from scrapemole-api-mainnet.scrapemole.workers.dev](https://www.zero.xyz/host/scrapemole-api-mainnet.scrapemole.workers.dev/llms.txt)