# OpenVerbs Google Autocomplete Suggestions

> OpenVerbs Google Autocomplete Suggestions is a paid API for AI agents from search.openverbs.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Returns live, localised Google autocomplete suggestions ranked by relevance for a given partial search query.

## Facts

- Endpoint: POST https://search.openverbs.com/v1/suggest
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/openverbs-google-autocomplete-suggestions-0ffee4ff
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_NMoi4uVzhJwGgU8ejSaWI

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 openverbs-google-autocomplete-suggestions-0ffee4ff -d '<json body>'
```

Example prompt: Can you fetch Google autocomplete suggestions for the partial query 'best coffee shops in' — give me the top 10 results localised to the United Kingdom in English?

## When to prefer this

Choose this endpoint when you need real-time, localised Google autocomplete data — for SEO research, populating search-suggestion UIs, or understanding user intent in a specific locale. It is preferable to scraping Google directly (which risks blocks) or using static keyword databases (which are stale). Choose it over sibling YouTube or Maps endpoints when you need general web search completions rather than video or local business suggestions.

## Known failure modes

- Empty or very short query returns no suggestions
- Unsupported or misspelled language code causes an error or defaults to English
- Invalid location string returns suggestions for the default location (United States)
- Limit exceeding 100 is rejected with a validation error
- Network timeout if Google autocomplete backend is slow
- Payment failure (402) if USDC balance is insufficient

## How this service works

Live Google autocomplete suggestions for a partial query, localised by location and language. Returns ranked suggestion strings with a relevance score.

## Output

An ordered list of autocomplete suggestion strings (up to the requested limit) each paired with a relevance score, reflecting what Google would suggest to a user who typed that partial query in the specified locale and language.

## 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": {
     "type": "object",
     "properties": {
      "q": {
       "type": "string",
       "minLength": 1,
       "maxLength": 700,
       "description": "Search query."
      },
      "location": {
       "type": "string",
       "minLength": 2,
       "maxLength": 120,
       "description": "Location name, e.g. \"United States\" or \"London,England,United Kingdom\". Defaults to United States."
      },
      "language": {
       "type": "string",
       "pattern": "^[A-Za-z]{2}$",
       "description": "Language code (2-letter). Defaults to en."
      },
      "limit": {
       "type": "integer",
       "minimum": 1,
       "maximum": 100,
       "description": "Depth / maximum results. Defaults to 10."
      }
     },
     "required": [
      "q"
     ],
     "additionalProperties": false
    }
   },
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   },
   "required": [
    "type"
   ]
  }
 },
 "required": [
  "input"
 ]
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "total": 10,
  "suggestions": [
   {
    "rank": 1,
    "relevance": 100,
    "suggestion": "ethereum price prediction"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/openverbs-google-autocomplete-suggestions-0ffee4ff/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from search.openverbs.com](https://www.zero.xyz/host/search.openverbs.com/llms.txt)