# YouTube Search Scraper

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

Scrapes YouTube search results for videos or channels by keyword, returning rich metadata like titles, views, publish dates, duration, subscribers, and thumbnails — no API key or quota required.

## Facts

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

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-search-scraper-3f3ce3b7 -d '<json body>'
```

Example prompt: Search YouTube for 'electric vehicle reviews' and give me the top 10 videos — I want the title, channel, view count, publish date, and duration for each. Search in English, US results only.

## When to prefer this

Choose this endpoint when you need YouTube video or channel metadata without a Google API key or quota constraints. It is ideal for research, competitive analysis, content monitoring, or localized search across languages and countries. Prefer it over the YouTube Data API when you want to avoid quota limits or don't have API credentials, and when scraping-level freshness (real-time search results) is sufficient.

## Known failure modes

- Query returns no results if the keyword is too obscure or misspelled
- YouTube anti-scraping measures may cause transient failures or partial results
- maxResultsPerQuery exceeding 30 is rejected by the schema
- Unsupported or invalid country/language codes may return unfiltered or unexpected results
- Network timeouts from the scraping layer may return empty or error responses

## 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 a list of YouTube search result items (up to 30 per query), each containing structured metadata. For videos: title, channel name, view count, publish date, duration, description snippet, thumbnail URL, and position. For channels: channel name, subscriber count, and description. Results respect the specified country and language filters.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "country": {
   "type": "string",
   "description": "Two-letter country for results."
  },
  "queries": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "maxItems": 1,
   "description": "What to search on YouTube."
  },
  "language": {
   "type": "string",
   "description": "Interface language, e.g. en, es, de."
  },
  "resultType": {
   "enum": [
    "video",
    "channel",
    "all"
   ],
   "type": "string",
   "description": "Filter results."
  },
  "maxResultsPerQuery": {
   "type": "integer",
   "maximum": 30,
   "description": "Paginated like scrolling the results page."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "items": [
   {
    "url": "https://www.youtube.com/watch?v=ix9cRaBkVe0",
    "type": "video",
    "query": "python tutorial",
    "title": "Python Full Course for free 🐍",
    "views": 13067252,
    "isLive": false,
    "channel": "Bro Code",
    "videoId": "ix9cRaBkVe0",
    "duration": "12:00:00",
    "position": 1,
    "channelId": "UC4SVo0Ue36XCfOyb5Lh1viQ",
    "published": "2 years ago",
    "thumbnail": "https://i.ytimg.com/vi/ix9cRaBkVe0/hq720.jpg?sqp=-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLAOFhprL8-MOLlhL-mAmfQX14h3JA",
    "description": "python #tutorial #beginners Python tutorial for beginners' full course 2024 *Learn Python in 1 HOUR* ..."
   }
  ]
 }
}
```

## More

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