# x402vid Search and Rank Videos

> x402vid Search and Rank Videos is a paid API for AI agents from x402vid.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-20).

Searches for videos by topic or keyword and returns AI-ranked results using Muse Spark 1.3 intelligence, billed per call in USDC via x402 protocol.

## Facts

- Endpoint: POST https://x402vid.com/tools/search_and_rank_videos?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-20
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402vid-search-and-rank-videos-667db538
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Gf8rZeiE7TdsGEwiRXTJW

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 x402vid-search-and-rank-videos-667db538 -d '<json body>'
```

Example prompt: Search for the top 10 videos about quantum computing using x402vid's AI ranking and show me what Muse Spark 1.3 considers most relevant.

## When to prefer this

Choose this endpoint when you need AI-ranked video search results on demand without a subscription, especially in agent workflows where pay-per-call billing via USDC is preferred. It is best suited for agents that need curated, relevance-ranked video lists rather than raw unranked search dumps, and when integration with the x402 micropayment protocol is already in place.

## Known failure modes

- Missing required search_term field returns a validation error
- num_videos exceeding 20 may be capped or rejected
- Payment failure via x402 protocol prevents execution
- Empty search term may return no results or an error
- Network timeout for searches on broad or high-volume terms

## How this service works

x402vid — endpoint discovery for YouTube intelligence: pay-per-call via x402 on Base. Muse Spark 1.3 video intelligence, 26 tools (20 paid +6 free) from $0.01. Free before you pay: GET /api/v1/catalog (every tool + price) → GET /api/v1/quote (freeze price) → video_preview. No subscriptions.

## Output

Returns a JSON object containing the search term, the AI model used (Muse Spark 1.3), an array of video objects matching the query, and an ai_ranking object describing how the videos were evaluated and ordered by relevance.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "search_term"
 ],
 "properties": {
  "num_videos": {
   "type": "integer",
   "description": "Number of results (default 5, max 20)"
  },
  "search_term": {
   "type": "string",
   "description": "Topic or keyword to search for"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "model": {
   "type": "string"
  },
  "videos": {
   "type": "array",
   "items": {
    "type": "object"
   }
  },
  "ai_ranking": {
   "type": "object"
  },
  "search_term": {
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402vid-search-and-rank-videos-667db538/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402vid.com](https://www.zero.xyz/host/x402vid.com/llms.txt)