# Scrappa Google Maps Autocomplete

> Scrappa Google Maps Autocomplete is a paid API for AI agents from scrappa.co, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-14).

Returns Google Maps autocomplete suggestions for partial place, address, or POI queries as users type

## Facts

- Endpoint: GET https://scrappa.co/api/maps/autocomplete
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/scrappa-google-maps-autocomplete-075e612f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3nUcO0kXNBR7i2X_hjXy9

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 scrappa-google-maps-autocomplete-075e612f
```

Example prompt: Can you get me Google Maps autocomplete suggestions for 'coffee shop Man' biased toward New York City (40.7128,-74.0060) in English?

## When to prefer this

Choose this endpoint when you need real-time Google Maps-powered place and address autocomplete suggestions for typeahead UI components, location search boxes, or address validation flows. It is ideal when you need geo-biased or language-filtered results and want Google Maps data quality via a simple pay-per-call REST API without managing a Google Maps API key.

## Known failure modes

- Missing required 'q' parameter returns a 400 error
- Invalid country code in 'gl' may return unfiltered or empty results
- Malformed latitude/longitude in 'll' parameter causes prediction bias to fail
- Query too vague or too short may return no predictions
- Payment not processed (x402 protocol failure) blocks the request
- Rate limiting if too many requests sent in quick succession

## How this service works

The Google Maps Autocomplete API provides automatic query predictions as users type. Helps users find places, addresses, and points of interest quickly. Accepts both "q" and "query" parameters for consistency with other autocomplete endpoints.

## Output

A JSON object containing an array of autocomplete predictions from Google Maps, each including a predicted place or address string and associated metadata such as place IDs and description components.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "q"
     ],
     "properties": {
      "q": {
       "type": "string",
       "description": "The partial search term to get autocomplete suggestions for. Accepts both \"q\" (consistent with Google Hotels) and \"query\"."
      },
      "gl": {
       "type": "string",
       "description": "Country/region code for geo-filtering results. Examples: us, de, uk, jp. Format: ISO 3166-1 alpha-2 country code."
      },
      "hl": {
       "type": "string",
       "description": "Language code for results. Default: en. Examples: en, de, fr, es. Format: ISO 639-1 two-letter language code."
      },
      "ll": {
       "type": "string",
       "description": "Latitude and longitude to bias results toward a specific location. Format: \"latitude,longitude\" (e.g., 40.7128,-74.0060 for New York City)."
      },
      "google_domain": {
       "type": "string",
       "description": "Google domain to use for the search. Examples: google.com, google.de, google.com.br, google.co.uk."
      }
     },
     "additionalProperties": true
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type",
    "example"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "json"
    },
    "example": {
     "type": "object"
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/scrappa-google-maps-autocomplete-075e612f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from scrappa.co](https://www.zero.xyz/host/scrappa.co/llms.txt)