# x402serps Video Search API

> x402serps Video Search API is a paid API for AI agents from x402serps.com, paid per call via x402, $0.004/call, status unknown (last checked 2026-11-11).

Returns video search results (title, URL, channel, duration, snippet, thumbnail) for a given query, paid per call in USDC via x402

## Facts

- Endpoint: POST https://x402serps.com/api/v1/videos?utm_source=zero.xyz
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402serps-video-search-api-8c48de23
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_YF47JleVc_DOiI9hXua8I

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 x402serps-video-search-api-8c48de23 -d '<json body>'
```

Example prompt: Search for videos about 'how to make sourdough bread' and give me the top 5 results from the US, including titles, channels, and durations.

## When to prefer this

Use this endpoint when you need structured video search results (with metadata like duration, channel, and thumbnail) for AI agent workflows, and you want to pay per query in USDC without maintaining API keys or accounts. Prefer this over general web search endpoints when the user specifically wants video content rather than web pages or news articles.

## Known failure modes

- Payment failure or insufficient USDC balance returns HTTP 402
- Empty or missing query string may return an error or zero results
- Unsupported or malformed country code (gl) may fall back to default or return an error
- Requesting more than 20 results may be clamped or rejected
- Network timeouts from the upstream search provider may cause 5xx errors

## How this service works

x402serps: Video results (title, url, channel, duration, date, thumbnail) for one query, up to 20

## Output

A JSON object containing the original query string, the name of the underlying provider, and an array of video result objects — each including position rank, title, URL, channel name, publication date, snippet text, video duration, and thumbnail image URL. Up to 20 results depending on the num parameter.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "q": {
   "type": "string",
   "description": "Query (alias: query)"
  },
  "gl": {
   "type": "string",
   "description": "Country code, e.g. us, gb"
  },
  "num": {
   "type": "number",
   "description": "Results 1-20, default 10"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "query": "x402 tutorial",
  "results": [
   {
    "url": "https://example.com/v/1",
    "date": "1 month ago",
    "title": "x402 in 5 minutes",
    "channel": "Example Dev",
    "duration": "5:12",
    "position": 1
   }
  ],
  "provider": "primary"
 }
}
```

## More

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