# Google Search Autocomplete with Knowledge Graph

> Google Search Autocomplete with Knowledge Graph is a paid API for AI agents from agents.openwebninja.com, paid per call via MPP, price unknown, status unknown (last checked 2026-10-14).

Returns Google Search query suggestions with character-level highlights and Knowledge Graph entity metadata for a given partial query string.

## Facts

- Endpoint: GET https://agents.openwebninja.com/web-search-autocomplete/autocomplete?utm_source=zero.xyz
- Price: price unknown
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Provider: agents.openwebninja.com
- Website: https://agents.openwebninja.com
- Canonical page: https://www.zero.xyz/c/agents-openwebninja-com-google-search-autocomplete-with-knowledge-graph-cd7be8c9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_JRdHZiu26lGzVRoEyMRcg

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 agents-openwebninja-com-google-search-autocomplete-with-knowledge-graph-cd7be8c9
```

Example prompt: What search suggestions does Google show when someone starts typing 'climate cha' in the US in English? Include any Knowledge Graph entity info if available.

## When to prefer this

Choose this endpoint when you need real-time Google-sourced search suggestions with character-level highlight metadata and optional Knowledge Graph entity enrichment (images, titles, descriptions). It is ideal for building search-as-you-type UI components, enriching autocomplete with entity context, or discovering popular query completions in a specific region and language. Prefer this over generic autocomplete APIs when Google's suggestion corpus and Knowledge Graph coverage matter.

## Known failure modes

- Missing required 'query' parameter returns a validation error
- Invalid region code (not ISO 3166-1 alpha-2) may return unexpected or empty results
- Invalid language code may fall back to default or return an error
- Query with no matching suggestions returns an empty data array
- Rate limiting or quota exhaustion returns a 429 or payment-required response
- Very long or malformed query strings may return an error or empty suggestions

## How this service works

Get query suggestions from Google Search, including Knowledge Graph information when available.

## Output

An array of autocomplete suggestion objects, each containing the full suggested query string, character-level highlight ranges (offset + length) indicating which parts match the input, and optional Knowledge Graph fields including entity title, subtitle, primary image URL, and additional image URLs. Also includes request metadata such as request_id, echoed parameters, and a status field.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "query"
 ],
 "properties": {
  "query": {
   "type": "string",
   "description": "Autocomplete / typeahead search query."
  },
  "region": {
   "type": "string",
   "default": "us",
   "description": "The country / region from which to make the query. Allowed values: 2-letter country code, see ISO 3166-1 alpha-2."
  },
  "language": {
   "type": "string",
   "default": "en",
   "description": "Set the language of the results. Allowed values: 2-letter language code, see ISO 639-1."
  },
  "user_agent": {
   "enum": [
    "desktop",
    "mobile"
   ],
   "type": "string",
   "default": "desktop",
   "description": "Device type to use for the search."
  },
  "cursor_pointer": {
   "type": "string",
   "description": "Cursor pointer defines the position of cursor for the query provided, position starts from 0 which is a case where cursor is placed before the query.  \n  If not provided acts as cursor is placed in the end of query (Google's cp parameter)."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "data": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "query",
     "highlights"
    ],
    "properties": {
     "query": {
      "type": "string",
      "description": "The suggested completion of the query."
     },
     "highlights": {
      "type": "array",
      "items": {
       "type": "object",
       "required": [
        "offset",
        "length"
       ],
       "properties": {
        "length": {
         "type": "integer",
         "description": "Length in characters of the matched range."
        },
        "offset": {
         "type": "integer",
         "description": "Zero-based character offset where the match starts within the suggestion."
        }
       }
      },
      "description": "Character ranges within the suggestion that match the input query (for bold rendering)."
     },
     "entity_image": {
      "type": "string",
      "nullable": true,
      "description": "Primary Knowledge Graph image URL for the entity, when available."
     },
     "entity_title": {
      "type": "string",
      "nullable": true,
      "description": "Knowledge Graph entity title associated with the suggestion, when available."
     },
     "entity_images": {
      "type": "array",
      "items": {
       "type": "string",
       "description": "Image URL."
      },
      "nullable": true,
      "description": "Additional Knowledge Graph image URLs for the entity, when available."
     },
     "entity_subtitle": {
      "type": "string",
      "nullable": true,
      "description": "Short Knowledge Graph subtitle / description of the entity (may be empty)."
     }
    }
   },
   "description": "List of autocomplete suggestions for the query."
  },
  "status": {
   "type": "string",
   "description": "The status of the response"
  },
  "parameters": {
   "type": "object",
   "properties": {
    "query": {
     "type": "string",
     "description": "The search query string"
    },
    "region": {
     "type": "string",
     "description": "The geographical region for the request"
    },
    "language": {
     "type": "string",
     "description": "The language used for the query"
    },
    "user_agent": {
     "type": "string",
     "description": "The user agent of the requester"
    },
    "cursor_pointer": {
     "type": "integer",
     "description": "A pointer indicating the current position in paginated results"
    }
   }
  },
  "request_id": {
   "type": "string",
  
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-openwebninja-com-google-search-autocomplete-with-knowledge-graph-cd7be8c9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.openwebninja.com](https://www.zero.xyz/host/agents.openwebninja.com/llms.txt)