Autocomplete

Retrieve place autocomplete suggestions from Google Maps for a given query. Returns suggestions for places, addresses, and businesses as users type, useful for building location search interfaces. Supports geographic biasing and filtering by place type.

HTTP Request

1
GET /autocomplete

Parameters

Parameter	Type	Required	Default	Description
`query`	string	Yes	—	The search query to get suggestions for
`language`	string	No	`"en"`	Language code for the response
`country`	string	No	`"us"`	Country code for regional bias
`lat`	number	No	—	Latitude to bias results toward a specific area
`lng`	number	No	—	Longitude to bias results toward a specific area
`filter_types`	string	No	—	Comma-separated list of place types to filter results (e.g., `restaurant,cafe`)

Response

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
{
  "status": true,
  "request_id": "2bdfc33d-cb14-a9d6-8189-e32223ad",
  "data": [
    {
      "title": "reading terminal market",
      "description": null,
      "google_id": null,
      "place_id": null,
      "latitude": null,
      "longitude": null,
      "country": null,
      "type": "other"
    },
    {
      "title": "reading terminal market parking",
      "description": null,
      "google_id": null,
      "place_id": null,
      "latitude": null,
      "longitude": null,
      "country": null,
      "type": "other"
    }
  ],
  "request_params": {
    "query": "Reading Terminal Mark"
  }
}

Response Fields

Field	Type	Description
`status`	boolean	`true` when the request succeeded
`request_id`	string	Unique identifier for this request
`data`	array	List of autocomplete suggestions
`data[].title`	string	The suggested search text, lowercased
`data[].description`	string/null	Secondary line, when the suggestion resolves to a place
`data[].google_id`	string/null	Business identifier, when the suggestion resolves to a place
`data[].place_id`	string/null	Google place ID, when available
`data[].latitude`	number/null	Latitude, when the suggestion resolves to a place
`data[].longitude`	number/null	Longitude, when the suggestion resolves to a place
`data[].country`	string/null	Country code, when available
`data[].type`	string	Suggestion type, e.g. `"other"` or `"general search"`

Notes

This endpoint returns search-term suggestions, the same list Google shows as you type. It is not a place lookup.
In practice most suggestions come back with google_id, place_id, and the coordinate fields set to null, because the suggestion is a query string rather than a specific business. To turn a name into a business identifier, use Locate and Search and read google_id from the first result.

Code Examples

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
import requests

url = "https://google-maps-extractor2.p.rapidapi.com/autocomplete"

querystring = {
    "query": "Joe's",
    "language": "en",
    "country": "us",
    "lat": "40.7128",
    "lng": "-74.0060"
}

headers = {
    "X-RapidAPI-Key": "YOUR_API_KEY",
    "X-RapidAPI-Host": "google-maps-extractor2.p.rapidapi.com"
}

response = requests.get(url, headers=headers, params=querystring)
data = response.json()

for suggestion in data["data"]:
    print(f"{suggestion['name']} ({suggestion['type']})")
    print(f"  {suggestion['address']}\n")

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
const url = "https://google-maps-extractor2.p.rapidapi.com/autocomplete";

const params = new URLSearchParams({
  query: "Joe's",
  language: "en",
  country: "us",
  lat: "40.7128",
  lng: "-74.0060",
});

const response = await fetch(`${url}?${params}`, {
  method: "GET",
  headers: {
    "X-RapidAPI-Key": "YOUR_API_KEY",
    "X-RapidAPI-Host": "google-maps-extractor2.p.rapidapi.com",
  },
});

const data = await response.json();

data.data.forEach((suggestion) => {
  console.log(`${suggestion.name} (${suggestion.type})`);
  console.log(`  ${suggestion.address}\n`);
});

1
2
3
4
5
6
7
8
curl -G "https://google-maps-extractor2.p.rapidapi.com/autocomplete" \
  --data-urlencode "query=Joe's" \
  --data-urlencode "language=en" \
  --data-urlencode "country=us" \
  --data-urlencode "lat=40.7128" \
  --data-urlencode "lng=-74.0060" \
  -H "X-RapidAPI-Key: YOUR_API_KEY" \
  -H "X-RapidAPI-Host: google-maps-extractor2.p.rapidapi.com"

Search Nearby — Search for businesses near a location
Business Details — Get full details for a suggested business
Query Locate — Geocode a location to coordinates