# AgentUtility Web Search — Ranked Google SERP via Decodo

> AgentUtility Web Search — Ranked Google SERP via Decodo is a paid API for AI agents from x402.agentutility.ai, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-13).

Returns ranked Google search results (title, URL, snippet, domain, recency) for a query, powered by Decodo, optimized for agent source discovery workflows.

## Facts

- Endpoint: POST https://x402.agentutility.ai/web-search
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentutility-web-search-ranked-google-serp-via-decodo-af3c29ed
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_h9joysienOto_zk84bkz7

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 agentutility-web-search-ranked-google-serp-via-decodo-af3c29ed -d '<json body>'
```

Example prompt: Search Google for 'best open-source LLM fine-tuning frameworks 2024' and return the top 10 ranked results with titles, URLs, snippets, and domains — filter for recent results only.

## When to prefer this

Choose this endpoint when an agent needs to discover sources, find URLs, or see ranked Google results before deciding what to fetch or synthesize. It is cheaper per call than hosted alternatives like SerpAPI or Serper.dev. Prefer it over answer-web when you want raw ranked links rather than a synthesized answer, and over scrape-to-json when you need SERP discovery rather than page content extraction. Best used as the first step in a research pipeline.

## Known failure modes

- Empty results for highly niche or obscure queries
- Rate limiting or quota exhaustion returning 429 errors
- Payment failure via x402 protocol if USDC balance is insufficient
- Query blocked or filtered by Google's content policies
- Stale results if recency filter is not applied to time-sensitive queries
- Network timeout on slow upstream Decodo responses

## How this service works

Ranked Google results for a query: title, URL, snippet, domain, and a recency filter, via Decodo Google Search. Built for agents that need source discovery before they read or synthesize; for fetched page text or cited answers use answer-web or scrape-to-json. Use it as a web search API, SERP API, Google search API, or real-time search endpoint for agents, at a lower per-call price than the common hosted search APIs.

## Output

A ranked list of Google search results, each containing: result title, URL, snippet/description, domain name, and position rank. May include a recency filter option to surface only fresh results. Does not return page body text — use a scraping or fetch endpoint for that.

## Request schema (JSON Schema)

```json
{
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "type": "object",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "type": "string",
     "enum": [
      "POST"
     ]
    },
    "bodyType": {
     "type": "string",
     "enum": [
      "json",
      "form-data",
      "text"
     ]
    },
    "body": {
     "properties": {
      "query": {
       "type": "string",
       "description": "Search query or research question. 1-500 chars."
      },
      "num_results": {
       "type": "number",
       "description": "Number of results to return. Default 10, max 20."
      },
      "limit": {
       "type": "number",
       "description": "Alias for num_results. If both are supplied, num_results wins."
      },
      "include_text": {
       "type": "boolean",
       "description": "Accepted for compatibility. This route always returns ranked result metadata with include_text: false; use scrape-to-json for page text."
      },
      "recency": {
       "type": "string",
       "enum": [
        "day",
        "week",
        "month",
        "year",
        "any"
       ],
       "description": "Optional freshness filter. Default 'any'."
      }
     },
     "required": [
      "query"
     ]
    }
   },
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "query": {
       "type": "string"
      },
      "results": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "title": {
          "type": "string"
         },
         "url": {
          "type": "string"
         },
         "snippet": {
          "type": "string"
         },
         "domain": {
          "type": "string"
         }
        }
       }
      },
      "source": {
       "type": "string"
      },
      "source_url": {
       "type": "string"
      },
      "degraded": {
       "type": "boolean"
      },
      "include_text": {
       "type": "boolean"
      },
      "note": {
       "type": "string"
      }
     }
    }
   },
   "required": [
    "type"
   ]
  }
 },
 "required": [
  "input"
 ]
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "query": "x402 payment protocol examples",
  "source": "Decodo Google Search",
  "results": [
   {
    "url": "https://example.com/x402",
    "title": "x402 documentation",
    "domain": "example.com",
    "snippet": "Pay-per-request protocol examples..."
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentutility-web-search-ranked-google-serp-via-decodo-af3c29ed/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.agentutility.ai](https://www.zero.xyz/host/x402.agentutility.ai/llms.txt)