# Horizon Pulse Web Search

> Horizon Pulse Web Search is a paid API for AI agents from horizonpulse.dev, paid per call via x402, $0.03/call, status unknown (last checked 2026-10-01).

Performs a web search via Google (Serper) and fetches the top 1-5 result pages, returning each as clean markdown/text with URL, title, rank, and per-source status

## Facts

- Endpoint: GET https://horizonpulse.dev/api/search?utm_source=zero.xyz
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/horizon-pulse-web-search-ccd9463e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_vgTbg7e2MI3-CpoZ0CM7z

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 horizon-pulse-web-search-ccd9463e
```

Example prompt: Search the web for 'best practices for LLM prompt engineering 2024' and fetch the top 3 result pages so I can read what they say.

## When to prefer this

Choose this endpoint when you need both the search ranking signal and the actual page content in one call — it saves two round trips (search + fetch). Ideal for research tasks where you want to read the top Google results rather than just see URLs. Prefer over a plain URL fetcher when you don't know which URLs to fetch, or over a raw search API when you need page content not just metadata.

## Known failure modes

- Search query missing or exceeds 300 characters → validation error
- Serper API unavailable → search step fails entirely with no results
- Individual result pages that block scraping → partial results returned with failed status for those sources
- SSRF-blocked URLs (private IPs, internal hosts) → those pages skipped
- n parameter outside 1-5 range → validation error or clamped to default of 3

## How this service works

Pay-per-call APIs for AI agents via x402 on Base: web fetch, HTTP proxy, page extract, and crypto market data.

## Output

Returns an array of up to 1-5 search result entries, each containing the page URL, title, rank position, fetch status, and the full page content rendered as clean markdown or plain text. Partial results are returned if some pages fail to fetch, with per-source error status indicated.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "q"
     ],
     "properties": {
      "n": {
       "type": "string",
       "description": "Number of result pages to fetch, integer 1-5 (default 3)."
      },
      "q": {
       "type": "string",
       "description": "Search query (required, <=300 chars)."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "description": "Horizon Pulse search-then-fetch result with sources. The example is a trimmed real response recorded from GET /api/demo/search at 2026-10-01T14:36Z UTC; live values differ on every call."
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "n": 2,
  "ok": true,
  "query": "x402 payment protocol",
  "results": [
   {
    "ok": true,
    "url": "https://x402.org/",
    "rank": 1,
    "title": "x402",
    "format": "markdown",
    "status": 200,
    "content": "# x402\n\nClose Search\n\n# x402\n\nx402 is an open, neutral standard for internet-native payments. It absolves the Internet’s…",
    "snippet": "x402 enables instant, low-cost payments for digital services. It's designed for API monetization, agentic commerce, paywalled content, and any scenario. The ...",
    "truncated": false
   }
  ],
  "provider": "serper (Google results)",
  "elapsedMs": 1860,
  "fetchedOk": 2,
  "resultCount": 2
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/horizon-pulse-web-search-ccd9463e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from horizonpulse.dev](https://www.zero.xyz/host/horizonpulse.dev/llms.txt)
