# YouTube Scraper

> YouTube Scraper is a paid API for AI agents from agent-data.centorprat.workers.dev, paid per call via x402, $0.04/call, status unknown (last checked 2026-10-29).

Scrapes YouTube videos from searches, channel feeds, or direct URLs returning full metadata including exact likes, views, comments, publish date, duration, channel info, hashtags, keywords, caption languages, and optional transcripts — no API key required.

## Facts

- Endpoint: POST https://agent-data.centorprat.workers.dev/tools/youtube-video-scraper?utm_source=zero.xyz
- Price: $0.04/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/youtube-scraper-beb3c4d0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_iSTvNV0gpSV1QqzfgeI9W

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-beb3c4d0 -d '<json body>'
```

Example prompt: Search YouTube for 'iphone 17 review' and give me the top 5 results with exact views, likes, comment counts, publish dates, and channel subscriber counts — no API key needed.

## When to prefer this

Choose this endpoint when you need rich, detailed YouTube video metadata (exact engagement stats, transcripts, channel info) without setting up a YouTube Data API key or managing OAuth. Ideal for agents doing content research, competitor analysis, channel monitoring, or transcript extraction at low per-call cost. Prefer over the official YouTube API when you need exact like counts (YouTube API hides these), transcripts, or want to avoid quota management.

## Known failure modes

- Video not found or URL is invalid — lookup is not charged
- Video is private or age-restricted — no data returned
- Channel handle or URL does not resolve — empty result
- Search returns fewer than requested results — partial array returned
- Transcript unavailable in requested language — transcript field empty or omitted
- Rate limiting or YouTube blocking — transient failure

## How this service works

Pay-per-call data and tools for AI agents, $0.002-0.01 per call in USDC via x402 (Base, Polygon or Solana), no account or API key; MAX tiers ($0.05-0.25) run deeper jobs. Agent toolkit: web search, search + read top pages, any page as clean markdown with a prompt-injection check, which-x402-API-to-call recommender, seller check. Data: Google Maps places with contacts, YouTube video data and transcripts, job listings (Indeed, LinkedIn, 13 boards), Google Ads Transparency, TikTok comments, Pinterest, Airbnb, Redfin, AliExpress, app stores, live sports, website and SEO checks, Shopify store tech stacks, and onchain token / address risk checks.

## Output

Returns an array of video objects, each containing: video title, exact view count, exact like count, comment count, publish date, video duration, channel name and subscriber count, full description, hashtags, keywords, available caption languages, and optionally the full transcript. Results are ordered by YouTube's ranking for searches, or reverse-chronological for channels.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "videos": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "maxItems": 5,
   "description": "Direct video URLs or IDs (watch, youtu.be, Shorts)."
  },
  "country": {
   "type": "string",
   "description": "Country code for search results, e.g. US, GB, DE."
  },
  "channels": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "maxItems": 1,
   "description": "Channel URLs, @handles or IDs: their latest videos."
  },
  "minViews": {
   "type": "integer",
   "description": "Keep videos with at least this many views."
  },
  "channelTab": {
   "enum": [
    "videos",
    "shorts",
    "streams"
   ],
   "type": "string",
   "description": "Which list of the channel to take."
  },
  "searchQueries": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "maxItems": 1,
   "description": "YouTube searches, e.g. [\"iphone 17 review\"]. Videos in YouTube's ranking order."
  },
  "publishedAfter": {
   "type": "string",
   "description": "Keep videos published on or after this date (YYYY-MM-DD)."
  },
  "includeTranscript": {
   "type": "boolean",
   "description": "Also return each video's transcript (charged per transcript)."
  },
  "maxResultsPerSearch": {
   "type": "integer",
   "maximum": 10,
   "description": "Top N videos per search."
  },
  "maxVideosPerChannel": {
   "type": "integer",
   "maximum": 10,
   "description": "Latest N videos per channel."
  },
  "transcriptLanguages": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "maxItems": 3,
   "description": "Preferred caption languages, e.g. [\"en\"]."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "items": [
   {
    "url": "https://www.youtube.com/watch?v=rng_yUSwrgU",
    "likes": 175172,
    "title": "iPhone 17 Review: No Asterisks!",
    "views": 7004132,
    "channel": "Marques Brownlee",
    "videoId": "rng_yUSwrgU",
    "keywords": [
     "iPhone 17",
     "iPhone 17 review",
     "iPhone 17 vs",
     "MKBHD"
    ],
    "channelId": "UCBJycsmduvYEL83R_U4JriQ",
    "description": "This is the best iPhone in years. Which can have an interesting effect on the rest of the lineup...\n\nMKBHD Merch: http://shop.MKBHD.com\n\nPlaylist of MKBHD Intro music: https://goo.gl/B3AWV5\n\nPhone provided by Apple for review.\n\n~\nhttp://twitter.com/MKBHD\nhttp://instagram.com/MKBHD\nhttp://facebook.com/MKBHD",
    "publishDate": "2025-10-01",
    "commentCount": 5800,
    "channelVerified": true,
    "durationSeconds": 680,
    "channelSubscribers": 21400000
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/youtube-scraper-beb3c4d0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent-data.centorprat.workers.dev](https://www.zero.xyz/host/agent-data.centorprat.workers.dev/llms.txt)