# HivemindOS Google Search Results

> HivemindOS Google Search Results is a paid API for AI agents from api.hivemindos.app, paid per call via x402, $0.03/call, status unknown (last checked 2026-10-28).

Returns ordered Google search results (title, URL, snippet) for a given query, showing which pages rank for a keyword

## Facts

- Endpoint: POST https://api.hivemindos.app/v1/x402/web-data/search.results?utm_source=zero.xyz
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-28
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hivemindos-google-search-results-7105c72d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_mvBB6bZpR5XWsXfEJL9f5

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 hivemindos-google-search-results-7105c72d -d '<json body>'
```

Example prompt: Can you pull the top 10 Google search results for 'best project management software' in the US and show me each page's title, URL, and snippet so I can see who's ranking?

## When to prefer this

Choose this endpoint when you need to see the actual organic Google SERP ranking order for a specific keyword — for SEO analysis, competitor research, content strategy, or market research. Prefer this over general web search tools when rank position and SERP snapshot data matter, and when you need structured title/URL/snippet data per ranking page rather than just a single answer or web content extraction.

## Known failure modes

- Query too short or empty — returns validation error
- Limit exceeds 100 — returns schema validation error
- Invalid country or language code — may default or return error
- Google SERP unavailable or rate-limited — service error response
- No results found for highly obscure queries — returns empty list
- Payment failure on x402 protocol — call not charged and not executed

## How this service works

Google search results: the pages Google ranks for a search, in order, with each one's title, address and snippet. Use it to see who ranks for a keyword. Use when an agent needs to know which pages rank on Google for a query, for SEO, competitor or market research. $0.03 this call, in USDC on Base; you pay only if it succeeds. HivemindOS SuperAgent API.

## Output

An ordered list of Google search results, each containing the page title, URL, and a snippet of text as displayed on the SERP, ranked from position 1 onwards up to the requested limit

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "maximum": 100,
   "minimum": 1,
   "description": "How many results, up to 100."
  },
  "query": {
   "type": "string",
   "maxLength": 500,
   "minLength": 1,
   "description": "The search to run."
  },
  "country": {
   "type": "string",
   "maxLength": 500,
   "minLength": 1,
   "description": "Two-letter country code, such as us or gb. Defaults to us."
  },
  "language": {
   "type": "string",
   "maxLength": 500,
   "minLength": 1,
   "description": "Two-letter language code, such as en. Defaults to en."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hivemindos-google-search-results-7105c72d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.hivemindos.app](https://www.zero.xyz/host/api.hivemindos.app/llms.txt)