# serp402 YouTube Search

> serp402 YouTube Search is a paid API for AI agents from serp402.com, paid per call via x402, $0.05/call, status unknown (last checked 2026-10-31).

Search YouTube and return structured JSON results including video titles, links, thumbnails, channels, and more

## Facts

- Endpoint: POST https://serp402.com/api/v1/youtube-search?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/serp402-youtube-search-8f1d0399
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_rpyz4MWAM9lKrfAnsj81p

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 serp402-youtube-search-8f1d0399 -d '<json body>'
```

Example prompt: Search YouTube for 'beginner Python tutorials' in English for the US and give me the top video titles, links, and channel names from the results.

## When to prefer this

Choose this endpoint when you need YouTube search results in structured JSON format without requiring a Google/YouTube API key, account, or subscription. It is ideal for AI agents that need pay-per-call access (at $0.05 USDC) with no setup overhead. Prefer it over the official YouTube Data API when avoiding quota management or API key provisioning is a priority, or when operating in an x402 micropayment-enabled agentic workflow.

## Known failure modes

- Invalid or unsupported country/language code returns an error or empty results
- Overly broad or empty search_query may return irrelevant results
- Rate limiting or payment failure if USDC balance is insufficient
- YouTube layout changes may temporarily break scraping and return incomplete data
- Pagination token (sp) mismatch causes no results or wrong page

## How this service works

YouTube: Video titles, links, thumbnails, channels and more. Structured JSON, USD 0.05 per call in USDC — no API key, no account, no subscription, no minimum. Not affiliated with, endorsed by or an official channel of any of the services the results come from. All trademarks and copyright remain the property of their respective owners.

## Output

Structured JSON containing YouTube search results, including video titles, URLs, thumbnail images, channel names, and potentially view counts, upload dates, and other metadata for each result matching the search query.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "gl": {
   "type": "string",
   "description": "country to use for the Google search. It's a two-letter country code. (e.g., us for the United States, uk for United Kingdom, or fr for France) Head to the…"
  },
  "hl": {
   "type": "string",
   "description": "language to use for the Youtube search. It's a two or three-letter language code. (e.g., en for English, es for Spanish, or fr for French), optionally…"
  },
  "sp": {
   "type": "string",
   "description": "Parameter can be used for pagination. Parameter can also be used to filter the search results: by Upload date , you need to set the sp parameter to CAI%3D by…"
  },
  "search_query": {
   "type": "string",
   "description": "search query. You can use anything that you would use in a regular YouTube search."
  }
 }
}
```

## More

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