Locate and Search

Combine geocoding and business search into a single API call. This endpoint first resolves your query to geographic coordinates, then searches for businesses in that area. Supports pagination with limit and offset parameters for retrieving large result sets.

HTTP Request

1
GET /google-maps/locate_and_search

Parameters

Parameter	Type	Required	Default	Description
`query`	string	Yes	—	Search query including location context (e.g., “restaurants in Chicago”)
`language`	string	No	`"en"`	Language code for the response
`country`	string	No	`"us"`	Country code for regional bias
`zoom`	integer	No	`7`	Map zoom level (3-21). Higher values narrow the search area
`limit`	integer	No	`20`	Maximum number of results to return
`offset`	integer	No	`0`	Number of results to skip for pagination

Response

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
{
  "status": "OK",
  "data": [
    {
      "business_id": "0x880e2ca25bfc4081:0x2862c4e61b8e4491",
      "name": "Girl & The Goat",
      "address": "809 W Randolph St, Chicago, IL 60607",
      "phone": "+1 312-492-6262",
      "rating": 4.6,
      "reviews_count": 4521,
      "category": "Restaurant",
      "latitude": 41.8844,
      "longitude": -87.6478,
      "website": "https://girlandthegoat.com"
    }
  ],
  "location": {
    "latitude": 41.8781136,
    "longitude": -87.6297982
  }
}

Response Fields

Field	Type	Description
`status`	string	Request status
`data`	array	List of matching businesses
`data[].business_id`	string	Unique business identifier
`data[].name`	string	Business name
`data[].address`	string	Full address
`data[].phone`	string	Phone number
`data[].rating`	number	Average rating (1-5)
`data[].reviews_count`	integer	Total number of reviews
`data[].category`	string	Primary business category
`data[].latitude`	number	Business latitude
`data[].longitude`	number	Business longitude
`data[].website`	string	Business website URL
`location`	object	Resolved coordinates for the query location
`location.latitude`	number	Latitude of the resolved location
`location.longitude`	number	Longitude of the resolved location

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
24
25
26
import requests

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

querystring = {
    "query": "restaurants in Chicago",
    "language": "en",
    "country": "us",
    "zoom": "7",
    "limit": "20",
    "offset": "0"
}

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()

print(f"Location: {data['location']['latitude']}, {data['location']['longitude']}\n")

for business in data["data"]:
    print(f"{business['name']} - {business['rating']} stars")
    print(f"  {business['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
25
26
27
const url = "https://google-maps-extractor2.p.rapidapi.com/google-maps/locate_and_search";

const params = new URLSearchParams({
  query: "restaurants in Chicago",
  language: "en",
  country: "us",
  zoom: "7",
  limit: "20",
  offset: "0",
});

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();

console.log(`Location: ${data.location.latitude}, ${data.location.longitude}\n`);

data.data.forEach((business) => {
  console.log(`${business.name} - ${business.rating} stars`);
  console.log(`  ${business.address}\n`);
});

1
2
3
4
5
6
7
8
9
curl -G "https://google-maps-extractor2.p.rapidapi.com/google-maps/locate_and_search" \
  --data-urlencode "query=restaurants in Chicago" \
  --data-urlencode "language=en" \
  --data-urlencode "country=us" \
  --data-urlencode "zoom=7" \
  --data-urlencode "limit=20" \
  --data-urlencode "offset=0" \
  -H "X-RapidAPI-Key: YOUR_API_KEY" \
  -H "X-RapidAPI-Host: google-maps-extractor2.p.rapidapi.com"

Query Locate — Geocode a location separately
Search Nearby — Search with explicit coordinates
Business Details — Get full details for a business from the results

HTTP Request

Parameters

Response

Response Fields

Code Examples

Related Endpoints