# AgentBodega Web Search

> AgentBodega Web Search is a paid API for AI agents from agentbodega.store, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-16).

Searches the public web and returns normalized, source-neutral results with titles, URLs, domains, snippets, freshness controls, and strict result caps for agent research workflows.

## Facts

- Endpoint: POST https://agentbodega.store/api/web/search
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 1
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentbodega-web-search-0f41eccc
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_joYzYfFlwonTtH9GInEf-

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 agentbodega-web-search-0f41eccc -d '<json body>'
```

Example prompt: Search the web for the latest news on lithium battery recycling regulations in the EU — give me up to 10 results with snippets, focusing on content from the past month.

## When to prefer this

Choose this endpoint when an agent needs live, normalized web search results with controllable freshness, result count caps, and optional snippet text for downstream reasoning — particularly when source neutrality and structured output matter more than raw search engine branding. Prefer it over scraping individual URLs when discovery across many domains is needed quickly.

## Known failure modes

- Empty results if query is too niche or freshness window is too narrow
- Timeout if timeoutMs is set too low for the query complexity
- Invalid freshness string format causes a 400 error
- Exceeding rate limits returns a 429 or payment-required response
- Site filter pointing to a domain with no indexable pages returns empty results

## How this service works

Search the public web and return normalized, source-neutral results with titles, URLs, domains, snippets, freshness controls, and strict result caps for agent research workflows.

## Output

A list of normalized web search results, each containing a title, URL, domain, and optionally a text snippet. Results are capped to the requested limit, filtered by freshness if specified, and scoped to a particular site if requested.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "body": {
     "fields": [
      {
       "name": "query",
       "type": "string",
       "required": true
      },
      {
       "name": "limit",
       "type": "integer",
       "required": false
      },
      {
       "name": "site",
       "type": "string",
       "required": false
      },
      {
       "name": "freshness",
       "type": "string",
       "required": false
      },
      {
       "name": "includeSnippets",
       "type": "boolean",
       "required": false
      },
      {
       "name": "timeoutMs",
       "type": "integer",
       "required": false
      }
     ],
     "required": [
      "query"
     ],
     "fieldCount": 6,
     "contentType": "application/json",
     "optionalPreview": [
      "limit",
      "site",
      "freshness",
      "includeSnippets",
      "timeoutMs"
     ],
     "omittedFieldCount": 0
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json"
     ],
     "type": "string"
    }
   }
  },
  "output": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string",
     "const": "json"
    },
    "example": {
     "type": "object",
     "additionalProperties": true
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentbodega-web-search-0f41eccc/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentbodega.store](https://www.zero.xyz/host/agentbodega.store/llms.txt)