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 /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`	Results to return per request. `20` is the default, not a cap — values up to `999` are accepted
`offset`	integer	No	`0`	Number of results to skip for pagination

On limit: the default of 20 is often mistaken for a maximum. It is not. Values are accepted up to 999, and the practical ceiling is how many businesses match your query, not the parameter. A live test of restaurants in Barcelona at limit=200 returned 184 results in a single request. Sparse queries return fewer, so treat limit as “give me up to this many” and paginate with offset when you need more.

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
30
31
32
33
34
35
36
37
38
39
40
41
{
  "status": true,
  "data": [
    {
      "name": "TJ Plumber Austin",
      "place_id": "ChIJM5TcYiS3RIYRy5xSroPDSyU",
      "google_id": "0x8644b72462dc9433:0x254bc383ae529ccb",
      "cid": "2687456572989414603",
      "full_address": "TJ Plumber Austin, 3605 Thompson St, Austin, TX 78702",
      "detailed_address": {
        "district": "Govalle",
        "street": "3605 Thompson St",
        "city": "Austin",
        "zip_code": "78702",
        "state": "Texas",
        "country": "US"
      },
      "phone": "(512) 661-7896",
      "full_phone": "+15126617896",
      "rating": 4.7,
      "reviews_count": 23,
      "main_category": "Plumber",
      "categories": ["Plumber"],
      "latitude": 30.2658307,
      "longitude": -97.6979515,
      "website_url": "https://tjplumberaustin.com/",
      "website_domain": "tjplumberaustin.com",
      "owner_name": "TJ Plumber Austin (Owner)",
      "can_claim": false,
      "status": "OPEN",
      "price_range": null,
      "time_zone": "America/Chicago"
    }
  ],
  "location": {
    "latitude": 30.267153,
    "longitude": -97.7430608,
    "altitude": 440421.35,
    "zoom": 7
  }
}

Response Fields

Field	Type	Description
`status`	boolean	Request status (`true` on success)
`data`	array	List of matching businesses
`data[].name`	string	Business name
`data[].place_id`	string	Google place ID (use in Maps URLs: `?q=place_id:...`)
`data[].google_id`	string	Google feature ID (hex pair)
`data[].cid`	string	Google customer ID
`data[].full_address`	string	Full address including business name
`data[].detailed_address`	object	Address broken into street, city, state, zip, country
`data[].phone`	string	Formatted phone number
`data[].full_phone`	string	Phone in E.164 format
`data[].rating`	number	Average rating (1-5)
`data[].reviews_count`	integer	Total number of reviews
`data[].main_category`	string	Primary business category
`data[].categories`	array	All business categories
`data[].latitude`	number	Business latitude
`data[].longitude`	number	Business longitude
`data[].website_url`	string\|null	Business website URL (`null` when the listing has none)
`data[].website_domain`	string\|null	Domain of the website URL
`data[].owner_name`	string	Listing owner name
`data[].can_claim`	boolean	Whether the listing is unclaimed
`data[].status`	string	Open status (e.g. `OPEN`)
`data[].price_range`	string\|null	Price range indicator
`data[].time_zone`	string	IANA time zone of the business
`location`	object	Resolved coordinates and zoom for the query location

Each business also carries working_hours, about, featured_photo, order_online_url, reservation fields, and hotel-specific fields (hotel_stars, hotel_about) where applicable.

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/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['full_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/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.full_address}\n`);
});

1
2
3
4
5
6
7
8
9
curl -G "https://google-maps-extractor2.p.rapidapi.com/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