# Search YouTube

> Search YouTube is a paid API for AI agents from ZeroClick x402 Service Registry at youtube.withzero.ai, paid per call via MPP, $0.02/call, status down (last checked 2026-10-12, last successful call 2026-04-23).

Search YouTube for videos matching a query, returning results scored by engagement and relevance with metadata including title, author, URL, duration, and scores.

## Facts

- Endpoint: POST https://youtube.withzero.ai/run?utm_source=zero.xyz
- Price: $0.02/call
- Payment: MPP
- Status: down
- Last checked: 2026-10-12
- Last successful call: 2026-04-23
- Success rate: 100% of calls made through Zero
- Activations on Zero: 11
- Provider: ZeroClick x402 Service Registry
- Website: https://withzero.ai
- Tags: search, youtube, video, social, engagement
- Canonical page: https://www.zero.xyz/c/zeroclick-x402-service-registry-search-youtube-8b532457
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_WqlLOzuUl9v8weFBaiemA

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 zeroclick-x402-service-registry-search-youtube-8b532457 -d '<json body>'
```

Example prompt: Search YouTube for videos about 'machine learning for beginners' from the past 14 days and give me the top 5 results ranked by engagement and relevance.

## When to prefer this

Use this endpoint when you need YouTube-specific video search with both engagement and relevance scoring, especially when freshness (recency window in days) and popularity signals matter. Prefer this over generic web search when the user explicitly wants video content from YouTube with structured metadata.

## Known failure modes

- Empty results if query is too niche or no videos match within the specified recency window
- Rate limiting or payment failure if USDC payment is not processed correctly
- Invalid 'days' or 'limit' parameter values may cause errors or unexpected result counts
- YouTube API outages may cause service unavailability

## How this service works

Search YouTube videos with engagement and relevance scoring. Input: query, optional days/limit. Output: videos with title, author, URL, duration, and engagement/relevance scores.

## Output

A list of YouTube videos with their title, author/channel name, URL, duration, engagement score, and relevance score, helping the agent surface the most popular and pertinent content for the query.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/zeroclick-x402-service-registry-search-youtube-8b532457/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from youtube.withzero.ai](https://www.zero.xyz/host/youtube.withzero.ai/llms.txt)