# meld402 Web Video Search

> meld402 Web Video Search is a paid API for AI agents from meld402.vercel.app, paid per call via x402, $0.15/call, status unknown (last checked 2026-09-15).

Searches for videos on YouTube and other sources using a query, returning ranked results with titles, URLs, views, channels, and durations — paid per request via USDC over x402.

## Facts

- Endpoint: POST https://meld402.vercel.app/api/web/video
- Price: $0.15/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/meld402-web-video-search-4d010e16
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_4w7f8K_ZVU0J3kpCZRyHg

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 meld402-web-video-search-4d010e16 -d '<json body>'
```

Example prompt: Search for the top 10 English-language YouTube videos about 'machine learning for beginners' — filter for medium-length videos and use US results.

## When to prefer this

Use this endpoint when an AI agent needs structured, ranked video search results from YouTube without managing a direct SerpApi subscription. It is ideal for agents that need to discover tutorials, trending content, or channel-specific videos on demand, paid per call in USDC with no API key management. Prefer this over raw SerpApi when you need a stable schema, x402 micropayment compatibility, and multi-source aggregation under one call.

## Known failure modes

- Empty or missing query returns a validation error
- num outside 1–20 range returns a schema error
- gl or hl not valid 2-letter codes returns a validation error
- Upstream SerpApi outage may result in degraded or empty results with the degraded field populated
- Payment failure over x402 returns 402 before any data is served
- Very niche queries may return few or zero results

## How this service works

14 paid data endpoints for autonomous agents and developers. Covers crypto intelligence (token, chain, Solana, gas), markets (FX, market pulse), location (weather), and research (news, brief). Each route aggregates multiple public sources into one stable schema with a single USDC payment over x402 on Base.

## Output

Returns a JSON object with a ranked list of up to 20 videos, each including the video URL, title, channel name, view count, publication date, duration, search engine source, and position. Also includes total result count, the original query, timestamp of the data, sources used (e.g. SerpApi), and attribution details.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "gl": {
   "type": "string",
   "default": "us",
   "maxLength": 2,
   "minLength": 2,
   "description": "Country code"
  },
  "hl": {
   "type": "string",
   "default": "en",
   "maxLength": 2,
   "minLength": 2,
   "description": "Language code"
  },
  "num": {
   "type": "integer",
   "default": 10,
   "maximum": 20,
   "minimum": 1,
   "description": "Number of videos"
  },
  "query": {
   "type": "string",
   "maxLength": 500,
   "minLength": 1,
   "description": "Video search query"
  },
  "duration": {
   "enum": [
    "short",
    "medium",
    "long"
   ],
   "type": "string",
   "description": "Video duration filter"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "query": "how to train a neural network",
   "videos": [
    {
     "url": "https://youtube.com/watch?v=abc123",
     "date": "2023-01-15T00:00:00Z",
     "title": "Neural Networks from Scratch",
     "views": 2500000,
     "engine": "youtube",
     "channel": "3Blue1Brown",
     "duration": "20:15",
     "position": 1
    },
    {
     "url": "https://youtube.com/watch?v=def456",
     "date": "2023-03-20T00:00:00Z",
     "title": "PyTorch Tutorial for Beginners",
     "views": 850000,
     "engine": "youtube",
     "channel": "Sentdex",
     "duration": "45:30",
     "position": 2
    }
   ],
   "total_results": 1200000
  },
  "meta": {
   "as_of": "2026-08-24T00:00:00.000Z",
   "sources": [
    "serpapi"
   ],
   "degraded": [],
   "attribution": [
    "Search data by SerpApi (serpapi.com)"
   ]
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/meld402-web-video-search-4d010e16/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from meld402.vercel.app](https://www.zero.xyz/host/meld402.vercel.app/llms.txt)