# Portals Protocol YouTube Search

> Portals Protocol YouTube Search is a paid API for AI agents from api.portalsprotocol.com, paid per call via x402, $0.09/call, status unknown (last checked 2026-09-15).

Searches YouTube for videos matching a query and returns a list of results up to a specified maximum count

## Facts

- Endpoint: POST https://api.portalsprotocol.com/youtube/search
- Price: $0.09/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-portalsprotocol-com-3c55695e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_WG3v9ZJs9oTXRZomvGyAO

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 api-portalsprotocol-com-3c55695e -d '<json body>'
```

Example prompt: Search YouTube for 'Python tutorial for beginners' and give me the top 5 results.

## When to prefer this

Use this endpoint when you need to programmatically search YouTube for videos by keyword and retrieve a structured list of results, especially in agentic workflows that need to discover video content without scraping YouTube directly. Prefer this over generic web search when the task is specifically scoped to YouTube video discovery.

## Known failure modes

- Invalid or empty query string returns an error
- maxResults value out of acceptable range causes rejection
- YouTube API quota exhausted returns an error
- Network timeout if YouTube is unreachable
- Payment failure via x402 protocol blocks the call

## Output

A list of YouTube video results (up to maxResults) matching the query, likely including video titles, IDs, URLs, and metadata such as descriptions or channel names.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "query",
  "maxResults"
 ],
 "properties": {
  "query": {
   "type": "string"
  },
  "maxResults": {
   "type": "number"
  }
 }
}
```

## More

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