# OpenVerbs YouTube Search

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

Returns live, localised YouTube video search results including title, URL, video ID, channel, view count, publish date, and duration for a given query.

## Facts

- Endpoint: POST https://search.openverbs.com/v1/youtube
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/openverbs-youtube-search-942c7602
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_WmVEXi8nZ8poLgwQ9xhDV

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 openverbs-youtube-search-942c7602 -d '<json body>'
```

Example prompt: Search YouTube for 'sourdough bread tutorial' and give me the top 5 results in English from the United States — I want each video's title, channel, view count, and link.

## When to prefer this

Choose this endpoint when you need live, structured YouTube search results with metadata (view count, publish date, duration, channel) and require localisation by country and language. Prefer it over scraping YouTube directly or using outdated cached data. Ideal for agents that need to surface relevant videos programmatically for a specific region or language audience.

## Known failure modes

- Empty results if query is too obscure or misspelled
- Rate limiting or payment failure (x402) if USDC payment is not processed
- Invalid language code (non-2-letter) returns a validation error
- Location string not recognised may fall back to default (United States)
- Limit exceeding 100 returns a validation error
- Network timeout if YouTube is slow to respond

## How this service works

Live YouTube video-search results for a query, localised by location and language. Returns ranked videos with title, URL, video id, channel, view count, publish date and duration.

## Output

A ranked list of YouTube videos matching the query, each containing the video title, YouTube URL, video ID, channel name, view count, publish date, and duration. Results are filtered and ranked according to the specified location and language context.

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "required": [
      "q"
     ],
     "properties": {
      "q": {
       "type": "string",
       "maxLength": 700,
       "minLength": 1,
       "description": "Search query."
      },
      "limit": {
       "type": "integer",
       "maximum": 100,
       "minimum": 1,
       "description": "Depth / maximum results. Defaults to 10."
      },
      "language": {
       "type": "string",
       "pattern": "^[A-Za-z]{2}$",
       "description": "Language code (2-letter). Defaults to en."
      },
      "location": {
       "type": "string",
       "maxLength": 120,
       "minLength": 2,
       "description": "Location name, e.g. \"United States\" or \"London,England,United Kingdom\". Defaults to United States."
      }
     },
     "additionalProperties": false
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "total": 500000,
  "results": [
   {
    "url": "https://www.youtube.com/watch?v=jxLkbJozKbY",
    "rank": 1,
    "title": "How Ethereum Works — A Clear Explanation",
    "views": 1250000,
    "isLive": false,
    "channel": "Finematics",
    "videoId": "jxLkbJozKbY",
    "isShorts": false,
    "published": "2025-11-02",
    "channelUrl": "https://www.youtube.com/@Finematics",
    "durationSeconds": 725
   }
  ]
 }
}
```

## More

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