# PayWeave YouTube Search API

> PayWeave YouTube Search API is a paid API for AI agents from youtube.payweave.services, paid per call via x402, $0.12/call, status unknown (last checked 2026-09-13).

Searches YouTube for videos matching a query and returns a list of video results, priced per call via x402 micropayment.

## Facts

- Endpoint: POST https://youtube.payweave.services/search
- Price: $0.12/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/payweave-youtube-search-api-c457f4dc
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_idy4PPtKVoTDkh1LBze0Y

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 payweave-youtube-search-api-c457f4dc -d '<json body>'
```

Example prompt: Search YouTube for 'Next.js full course for beginners' and give me the top 10 results.

## When to prefer this

Choose this endpoint when you need programmatic, pay-per-call access to YouTube video search results without managing a YouTube Data API key or quota. It is especially useful for agents that need occasional or variable-volume YouTube searches and want to pay only for what they use via x402 micropayments, avoiding API key setup overhead.

## Known failure modes

- Query string missing — returns error if no search terms provided
- Limit exceeds maximum of 100 — rejected with validation error
- Payment not included or insufficient — x402 payment required before results are returned
- YouTube API quota or downstream outage — may return 503 or empty results
- Ambiguous or very short query — may return loosely relevant or low-quality results

## How this service works

YouTube data — video search and video details.

## Output

A list of YouTube video results (up to the requested limit), each containing video metadata such as title, video ID, description, channel, and other available details surfaced by the YouTube data API.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "maximum": 100,
   "minimum": 1,
   "description": "Number of videos to return (default 20, max 100). Price scales with this value."
  },
  "query": {
   "type": "string",
   "description": "Search terms, e.g. \"cloudflare workers tutorial\""
  }
 }
}
```

## More

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