# x402serps Search + Extract API

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

Performs a Google web search and extracts full page content for the top results, returning titles, snippets, and markdown-rendered page text in a single call

## Facts

- Endpoint: POST https://x402serps.com/api/v1/search-extract?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402serps-search-extract-api-0b612011
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_sJJqKe3ghOhJe0z4xbdmE

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-search-extract-api-0b612011 -d '<json body>'
```

Example prompt: Search the web for 'best open-source LLM fine-tuning frameworks 2025' and pull the full content from the top 3 results so I can read what they actually say.

## When to prefer this

Choose this endpoint when your agent needs both search result metadata AND the full readable content of web pages in a single call, eliminating the need to chain a search API with a separate scraper. It is especially useful for agents that need current, real-world information without managing API keys or subscriptions — payment is handled per-call in USDC via x402. Prefer it over search-only APIs when you need to read what the pages actually say, not just their titles and snippets.

## Known failure modes

- Individual page extraction may fail (per-result error field populated) if the target site blocks scraping or times out
- Query with no results returns an empty results array
- Exceeding n=5 results limit may be rejected or capped
- Payment failure via x402 returns HTTP 402 before the query is processed
- Very large pages may be truncated if content exceeds maxChars limit

## How this service works

x402serps: Web search plus clean extracted markdown of the top N results (default 3, max 5) in one call

## Output

Returns a JSON object with the original query, provider name, and an array of results. Each result includes position, URL, title, snippet, and a content object with the extracted page text in markdown format, final URL after redirects, content length, content type, and a truncation flag.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "n": {
   "type": "number",
   "description": "Results to extract 1-5, default 3"
  },
  "q": {
   "type": "string",
   "description": "Search query (alias: query)"
  },
  "maxChars": {
   "type": "number",
   "description": "Max chars per page, default 15000"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "query": "how does x402 work",
  "results": [
   {
    "url": "https://www.x402.org/",
    "title": "x402 payments protocol",
    "content": {
     "url": "https://www.x402.org/",
     "title": "x402",
     "length": 5210,
     "markdown": "# x402\n\n...",
     "truncated": false
    },
    "snippet": "An open standard for internet-native payments over HTTP 402.",
    "position": 1
   }
  ],
  "provider": "primary"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402serps-search-extract-api-0b612011/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)
