# AdFreeLLM YouTube Search API

> AdFreeLLM YouTube Search API is a paid API for AI agents from speecship.com, paid per call via x402, $0.03/call, status unknown (last checked 2026-09-13).

Searches YouTube and returns a list of matching video results (URL, title, channel) for a given query, paid per-call in USDC via x402.

## Facts

- Endpoint: POST https://speecship.com/relay/1787408884843/social/youtube
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/adfreellm-youtube-search-api-c65aca83
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_wUzPTsr4-NaKNlsYdaZV_

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

Example prompt: Search YouTube for 'machine learning for beginners' and give me the top 5 video results with their titles and channel names.

## When to prefer this

Choose this endpoint when you need programmatic YouTube video search without a Google API key or subscription, and want to pay only per request in USDC. Ideal for AI agents doing one-off or infrequent YouTube research tasks, competitive content analysis, or trend discovery without committing to a recurring API plan.

## Known failure modes

- Query string missing or empty — returns validation error
- Limit out of range (below 1 or above 10) — returns validation error
- No results found for the query — may return empty array
- Payment not provided or insufficient USDC — x402 payment required error
- Upstream YouTube search unavailable — returns 5xx or timeout error

## How this service works

Agent-ready Google Search, web crawling, Maps, social, and App Store review research APIs. Pay per request in USDC over x402—no subscription or API key required.

## Output

An array of JSON objects, each containing a YouTube video URL (youtube.com/watch?v=...), the video title, and the channel name. The number of results is bounded by the requested limit (1–10, default 5).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "default": 5,
   "maximum": 10,
   "minimum": 1
  },
  "query": {
   "type": "string",
   "maxLength": 500,
   "minLength": 1,
   "description": "YouTube search query"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": [
  {
   "url": "https://www.youtube.com/watch?v=example",
   "title": "Example video",
   "channelName": "Example"
  }
 ]
}
```

## More

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