# spipe Web Search API

> spipe Web Search API is a paid API for AI agents from spip39.vercel.app, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Performs web searches and returns ranked results for a given query, with optional filtering by count, country, language, recency, and safe search level

## Facts

- Endpoint: GET https://spip39.vercel.app/search
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/spipe-web-search-api-d20f4904
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_5oZ89T9fnVcHMmbXGbbPk

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 spipe-web-search-api-d20f4904
```

Example prompt: Search the web for the latest news about quantum computing breakthroughs and give me 10 results from the US in English, with only the most recent articles.

## When to prefer this

Use this endpoint when an AI agent needs to retrieve live, ranked web search results programmatically with per-query micropayment billing via x402 on Base, especially when filtering by geography, language, or recency is important. Prefer this over static knowledge bases when up-to-date web content is required.

## Known failure modes

- Missing required 'q' parameter returns an error
- Invalid country or language code may return no results or an error
- Overly broad queries may return low-relevance results
- Freshness filter with very narrow recency may return zero results
- Count values outside 1-20 range may be rejected or clamped
- Payment failure or insufficient USDC balance blocks the request

## How this service works

Web search, content extraction, and research APIs for AI agents. x402 on Base.

## Output

A JSON object containing ranked web search results for the query, including page titles, URLs, and descriptive snippets, filtered according to the specified count, country, language, freshness, and safe search parameters.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "q"
 ],
 "properties": {
  "q": {
   "type": "string",
   "description": "Search query"
  },
  "count": {
   "type": "integer",
   "description": "Number of results (1-20)"
  },
  "country": {
   "type": "string",
   "description": "Country code (US, GB, etc.)"
  },
  "language": {
   "type": "string",
   "description": "Language code"
  },
  "freshness": {
   "enum": [
    "day",
    "week",
    "month",
    "year"
   ],
   "type": "string",
   "description": "Filter by recency"
  },
  "safesearch": {
   "enum": [
    "off",
    "moderate",
    "strict"
   ],
   "type": "string",
   "description": "Safe search level"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object"
}
```

## More

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