# agentx.sale YouTube Search

> agentx.sale YouTube Search is a paid API for AI agents from agentx.sale, paid per call via x402, $0.01/call, status unknown (last checked 2026-11-16).

Search YouTube and retrieve up to 20 results with title, channel, views, publish age, and thumbnails

## Facts

- Endpoint: GET https://agentx.sale/x402/youtube-search?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentx-sale-youtube-search-ab97cde2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ASrqClEMNA1M1NXCGqrvE

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 agentx-sale-youtube-search-ab97cde2
```

Example prompt: Search YouTube for 'sourdough bread recipe' and give me the top 10 video results, including titles, channels, view counts, and thumbnails.

## When to prefer this

Use this endpoint when you need programmatic YouTube search results with structured metadata (titles, channels, views, thumbnails, publish age) without scraping YouTube directly or using the official YouTube Data API. It is ideal for agents that need quick, pay-per-call access to YouTube data at $0.01 per query, especially when you want to filter results by videos or channels specifically.

## Known failure modes

- Missing required 'q' parameter returns a 400 error
- Limit value outside 1-20 range may be rejected or clamped
- Invalid filter value (not 'video' or 'channel') returns a 400 error
- Payment not provided or insufficient USDC results in 402 Payment Required
- YouTube query returns zero results for very obscure or misspelled queries
- Rate limiting or upstream YouTube availability issues may cause 5xx errors

## How this service works

YouTube search: up to 20 results with title, channel, views, publish age and thumbnails. GET ?q=<query>&limit=<1-20>&filter=<video|channel>

## Output

A list of up to 20 YouTube search results, each containing the video or channel title, channel name, view count, publish age (how long ago it was posted), and a thumbnail image URL. Results are filtered by type (video or channel) based on the query parameters.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "q"
     ],
     "properties": {
      "q": {
       "type": "string"
      },
      "limit": {
       "type": "integer"
      },
      "filter": {
       "enum": [
        "video",
        "channel"
       ],
       "type": "string"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 2,
  "query": "x402 payments",
  "filter": "video",
  "results": [
   {
    "url": "https://www.youtube.com/watch?v=S6wc6yvoZLY",
    "title": "AI agents are paying each other now",
    "views": "488,749 views",
    "channel": "Fireship",
    "videoId": "S6wc6yvoZLY"
   }
  ]
 }
}
```

## More

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