google_maps_data_max

🚀 Google Maps Search API Documentation

Welcome to the Google Maps Search API! This document provides detailed information on how to interact with our endpoints to retrieve valuable place and business data from Google Maps. All requests are authenticated using headers provided by RapidAPI.

🔑 Authentication

Authentication is required for all API endpoints. You must include the following headers in every request:

Header	Type	Required	Description
x-rapidapi-key	string	✅ Yes	Your personal key from your RapidAPI subscription.
x-rapidapi-host	string	✅ Yes	The API host: `google-maps-data-max.p.rapidapi.com`

📍 1. Search for Places

This endpoint allows you to search for places on Google Maps using keywords and various geographic filters. It supports pagination and sorting by the total number of reviews.

Method & Path: POST /api/google/maps/search/max/

▶️ Request Body

Parameter	Type	Required	Description
search_word	string	✅ Yes	A keyword to search for places (e.g., "coffee", "Starbucks").
address	string	❌ No	The address or general area to search within (e.g., "new york"). This parameter is mutually exclusive with `country_code` and `domain_name`.
country_code	string	❌ No	A two-letter ISO 3166-1 alpha-2 country code to limit the search (e.g., "US", "DE", "CN"). Mutually exclusive with `address`.
domain_name	string	❌ No	Filter results by the business's domain name (e.g., "starbucks.com"). Mutually exclusive with `address`.
reviews_total_sort_mode	string	❌ No	Sort results by the total number of reviews. Valid options: `asc` or `desc`.
page_number	integer	❌ No	The page number for pagination. Defaults to `1`.
page_size	integer	❌ No	The number of results per page. Defaults to `10`. Max to 500

Important on Search Filters: To define a search area, you must use either the address parameter or a combination of country_code and/or domain_name. These options are mutually exclusive.

✅ Success Response (200 OK)

{
"code": "integer",
"result": {
"search_word": "string",
"address": "string | null",
"country_code": "string | null",
"domain_name": "string | null",
"reviews_total_sort_mode": "string | null",
"page_number": "integer",
"page_size": "integer",
"total": "integer",
"count": "integer",
"data": [
{
"unique_id": "string",
"name": "string",
"category_names": ["string"],
"country_code": "string",
"country_name": "string",
"state_name": "string",
"city_name": "string",
"district_name": "string",
"address": "string",
"reviews_rating": "number",
"reviews_total": "integer",
"latitude": "number",
"longitude": "number",
"image_urls": ["string (url)"],
"phone_numbers": ["string"],
"website_urls": ["string (url)"],
"url": "string (url)"
}
]
},
"message": "string"
}

ℹ️ 2. Get Place Details

This endpoint retrieves detailed information for a single place by providing its unique identifier (unique_id).

Method & Path: POST /api/google/map/

▶️ Request Body

Parameter	Type	Required	Description
unique_id	string	✅ Yes	The unique identifier for the place, obtained from the "Search for Places" endpoint (e.g., "17873551672904412049").

✅ Success Response (200 OK)

{
"code": "integer",
"result": {
"unique_id": "string",
"data": {
"unique_id": "string",
"name": "string",
"category_names": ["string"],
"country_code": "string",
"country_name": "string",
"state_name": "string",
"city_name": "string",
"district_name": "string",
"address": "string",
"reviews_rating": "number",
"reviews_total": "integer",
"latitude": "number",
"longitude": "number",
"image_urls": ["string (url)"],
"phone_numbers": ["string"],
"website_urls": ["string (url)"],
"url": "string (url)"
}
},
"message": "string"
}