# meld402 Web Search

> meld402 Web 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-13).

Performs a web search query and returns ranked results aggregated from multiple search engines (Google, Bing, DuckDuckGo) via SerpApi, paid per request over x402.

## Facts

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

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-search-0d99fe77 -d '<json body>'
```

Example prompt: Search the web for 'best open-source LLMs in 2025' and give me the top 10 results in English from the US, with safe search on.

## When to prefer this

Choose this endpoint when you need aggregated web search results from multiple engines (Google, Bing, DuckDuckGo) in a single stable schema, and you want per-request micropayment billing via USDC on Base rather than a subscription. Ideal for autonomous agents that search intermittently and need localized, paginated results without managing multiple search API keys.

## Known failure modes

- Empty or missing query returns validation error
- Query exceeding 500 characters rejected
- Invalid country or language code may return unexpected locale results
- Upstream SerpApi degradation results in partial or empty results with degraded source flag
- Payment failure over x402 blocks the request before execution
- num outside 1-20 range returns validation error

## 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 containing an array of ranked web results (each with URL, title, snippet, position, and source engine), plus total result count, search time in milliseconds, data sources used (SerpApi), and an as-of timestamp.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "gl": {
   "type": "string",
   "default": "us",
   "maxLength": 2,
   "minLength": 2,
   "description": "Country code for localization (ISO 3166-1 alpha-2)"
  },
  "hl": {
   "type": "string",
   "default": "en",
   "maxLength": 2,
   "minLength": 2,
   "description": "Language code for localization (ISO 639-1)"
  },
  "num": {
   "type": "integer",
   "default": 10,
   "maximum": 20,
   "minimum": 1,
   "description": "Number of results to return"
  },
  "safe": {
   "enum": [
    "active",
    "off"
   ],
   "type": "string",
   "default": "active",
   "description": "Safe search filter"
  },
  "query": {
   "type": "string",
   "maxLength": 500,
   "minLength": 1,
   "description": "Search query"
  },
  "start": {
   "type": "integer",
   "default": 0,
   "maximum": 9007199254740991,
   "minimum": 0,
   "description": "Result offset for pagination"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "query": "artificial intelligence trends 2024",
   "results": [
    {
     "url": "https://example.com/ai-trends-2024",
     "title": "AI Trends 2024: What Experts Predict",
     "snippet": "Leading AI researchers share their predictions for the year ahead...",
     "position": 1,
     "source_engine": "google"
    },
    {
     "url": "https://example.com/state-of-ai-2024",
     "title": "The State of AI in 2024",
     "snippet": "Comprehensive analysis of AI adoption across industries...",
     "position": 2,
     "source_engine": "bing"
    },
    {
     "url": "https://example.com/genai-market",
     "title": "Generative AI Market Growth",
     "snippet": "Market analysis shows 40% YoY growth in generative AI...",
     "position": 3,
     "source_engine": "duckduckgo"
    }
   ],
   "total_results": 1250000000,
   "search_time_ms": 847
  },
  "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-search-0d99fe77/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)