# Hirescrape YouTube Scraper API

> Hirescrape YouTube Scraper API is a paid API for AI agents from www.hirescrape.com, paid per call via x402, $0.00225/call, status unknown (last checked 2026-09-15).

Scrapes YouTube videos, channels, comments, hashtags, keywords, and trending content via a pay-per-call API with no API key required

## Facts

- Endpoint: POST https://www.hirescrape.com/api/tools/youtube
- Price: $0.00225/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hirescrape-youtube-scraper-api-ce144f1b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_nfbouiGQoHnsyPNGw8r3T

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 hirescrape-youtube-scraper-api-ce144f1b -d '<json body>'
```

Example prompt: Pull the top 50 YouTube videos matching the keyword 'AI agents' uploaded in the last month, sorted by popularity — I need the titles, view counts, and channel names.

## When to prefer this

Use this endpoint when you need to scrape YouTube data (videos, channels, comments, hashtags, keyword searches, trending content) without a YouTube Data API key, especially in AI agent workflows that support x402 micropayment settlement. Prefer this over the official YouTube API when you need flexible scraping modes like podcast URL discovery, search filter combinations, or cross-tab channel data.

## Known failure modes

- Invalid or inaccessible YouTube URL returns empty items array
- Unsupported mode value causes validation error
- limit exceeds maximum of 500 and is rejected
- Insufficient USDC wallet balance causes payment failure via x402
- Rate limiting or YouTube blocking causes partial or empty results
- Invalid country code or date format causes parameter error

## How this service works

Pay-per-call web scrapers for AI agents. 28 tools across Reddit, 8-board job search (LinkedIn · Indeed · Glassdoor · Google Jobs · +5), TikTok · Douyin · Bilibili, cross-platform trend research, social media, and ad libraries. No API keys. Agent wallets settle USDC on Tempo or Base via x402 + MPP.

## Output

Returns a JSON object with an 'items' array of scraped YouTube entities (videos, channels, comments, etc.) whose shape depends on the mode used, plus a runId for debugging, a payment settlement summary, and the run duration in seconds.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "url": {
   "type": "string",
   "description": "Full URL of the target object."
  },
  "mode": {
   "enum": [
    "video",
    "videos_by_explore",
    "videos_by_hashtag",
    "videos_by_keyword",
    "videos_by_podcast_url",
    "videos_by_search_filters",
    "videos_by_url",
    "channel",
    "channels_by_keyword",
    "comments"
   ],
   "type": "string",
   "default": "video",
   "description": "Which endpoint to call. Options: video, videos_by_explore, videos_by_hashtag, videos_by_keyword, videos_by_podcast_url, videos_by_search_filters, videos_by_url, channel, channels_by_keyword, comments."
  },
  "type": {
   "type": "string",
   "description": "Content type (all or shorts)."
  },
  "limit": {
   "type": "integer",
   "default": 20,
   "maximum": 500,
   "minimum": 1,
   "description": "Max items to collect (applies to paginated modes)."
  },
  "country": {
   "type": "string",
   "description": "Country code (e.g. US, GB)."
  },
  "hashtag": {
   "type": "string",
   "description": "Hashtag (without #)."
  },
  "keyword": {
   "type": "string",
   "description": "Search keyword."
  },
  "sort_by": {
   "type": "string",
   "description": "Sort key (depends on endpoint)."
  },
  "all_tabs": {
   "type": "boolean",
   "description": "Scrape all tabs on the destination page."
  },
  "duration": {
   "type": "string",
   "description": "Duration filter (Under 4 minutes / 4-20 minutes / Over 20 minutes)."
  },
  "end_date": {
   "type": "string",
   "description": "End date (YYYY-MM-DD)."
  },
  "features": {
   "type": "string",
   "description": "Feature filter (4K / HD / Creative Commons / Subtitles)."
  },
  "order_by": {
   "type": "string",
   "description": "Sort order for discovered videos (Latest / Oldest / Popular)."
  },
  "start_date": {
   "type": "string",
   "description": "Start date (YYYY-MM-DD)."
  },
  "time_period": {
   "type": "string",
   "description": "Lookback window (e.g. '1 day ago', '1 month ago', '1 year ago')."
  },
  "upload_date": {
   "type": "string",
   "description": "Upload recency filter (Today / Week / Month / Year)."
  },
  "num_of_posts": {
   "type": "integer",
   "description": "Max records to collect (0 = provider default)."
  },
  "keyword_search": {
   "type": "string",
   "description": "Keyword for filtered video search."
  },
  "transcription_language": {
   "type": "string",
   "description": "BCP-47 language code for transcript (e.g. en, es). Empty = auto."

… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "schema": {
  "type": "object",
  "required": [
   "items"
  ],
  "properties": {
   "items": {
    "type": "array",
    "items": {
     "type": "object"
    },
    "description": "Scraped items. Shape varies per tool — see each tool's outputSample for a concrete example."
   },
   "runId": {
    "type": "string",
    "description": "Run ID for debugging/audit."
   },
   "payment": {
    "type": "object",
    "description": "Settlement summary (protocol, amount, currency)."
   },
   "duration": {
    "type": "integer",
    "description": "Run duration in seconds."
   }
  }
 },
 "example": {
  "items": [
   {
    "note": "Shape varies per tool — see each tool's docs for fields."
   }
  ],
  "runId": "sc_example",
  "payment": {
   "amount": "0.040000",
   "currency": "USD",
   "protocol": "x402"
  },
  "duration": 4
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hirescrape-youtube-scraper-api-ce144f1b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from www.hirescrape.com](https://www.zero.xyz/host/www.hirescrape.com/llms.txt)