# Citiview SERP Search Engine Results

> Citiview SERP Search Engine Results is a paid API for AI agents from agents.citiviewgroup.com, paid per call via x402, $0.009/call, status unknown (last checked 2026-10-14).

Returns up to 20 structured organic search results (position, title, link, snippet, domain, favicon) for a given query, in classic SERP format.

## Facts

- Endpoint: GET https://agents.citiviewgroup.com/v1/serp?utm_source=zero.xyz
- Price: $0.009/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/citiview-serp-search-engine-results-18cca003
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3jlkJmQfFcLqCQjt460Wa

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 citiview-serp-search-engine-results-18cca003
```

Example prompt: Search for 'best open-source LLM frameworks 2025' and give me the top 10 organic results — I want the title, URL, and snippet for each so I can see what's ranking right now.

## When to prefer this

Choose this endpoint when you need structured SERP data in a machine-readable format for SEO analysis, rank tracking, or content research — especially when you need position, snippet, and domain metadata together in one call. Prefer it over raw web scraping when you want clean, pre-parsed organic results without parsing HTML. It is ideal for agentic workflows that need to programmatically process multiple search results at once.

## Known failure modes

- Missing required query parameter 'q' returns a 400 error
- num outside range 1–20 may be rejected or clamped
- Empty or nonsensical query may return zero organic results
- Rate limiting or payment failure returns a 402 or 429 error
- Very niche queries may return fewer results than requested

## How this service works

Search engine results page in the familiar SERP shape: organic_results with position, title, link, displayed_link, domain, favicon and snippet, plus total results and top domains. Up to 20 results. For SEO, rank tracking and research agents.

## Output

A structured list of up to 20 organic search results, each containing position number, title, link URL, displayed link, domain, favicon URL, and snippet text, plus the total estimated result count and a list of top domains present in the results.

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "q"
     ],
     "properties": {
      "q": {
       "type": "string"
      },
      "num": {
       "type": "integer",
       "description": "1 to 20, default 10"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/citiview-serp-search-engine-results-18cca003/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.citiviewgroup.com](https://www.zero.xyz/host/agents.citiviewgroup.com/llms.txt)