# Maps Data

> Search for businesses and places using Google Maps data and retrieve reviews.

Source: https://cotera.co/docs/reference/tools/individual-tools/maps-data

---

**Authentication Type:** API Key\
**Description:** Search for businesses and places using Google Maps data and retrieve reviews.

***

## Authentication

To authenticate, you'll need a RapidAPI key for the [Maps Data API](https://rapidapi.com/alexanderxbx/api/maps-data/).

**Note:** The free plan includes 1000 requests per month.

***

## Location Search

Search for businesses and places using Google Maps data.

### Search Locations

Search for businesses, restaurants, stores, and other places. Returns business details including location, contact info, ratings, and photos. Use specific search terms for better results (e.g., "dentist", "pizza restaurant", "coffee shop").

**Operation Type:** Query (Read)

**Parameters:**

* **query** `string` (required): Search query for businesses or places
* **limit** `number` (nullable): Maximum number of results (max 500, default 20)
* **country** `string` (nullable): Country code for search (default: us)
* **lang** `string` (nullable): Language code (default: en)
* **lat** `number` (nullable): Latitude for search point (default: 51.5072)
* **lng** `number` (nullable): Longitude for search point (default: 0.12)
* **offset** `number` (nullable): Offset for pagination (default: 0)
* **zoom** `number` (nullable): Zoom level for search (default: 13)

**Returns:**

* **status** `string`: API response status
* **data** `array of objects`: Array of business search results
  * **business\_id** `string`: Unique business identifier
  * **phone\_number** `string` (nullable): Business phone number
  * **name** `string`: Business name
  * **full\_address** `string`: Complete business address
  * **full\_address\_array** `array of strings`: Address components array
  * **latitude** `number`: Latitude coordinate
  * **longitude** `number`: Longitude coordinate
  * **review\_count** `number` (nullable): Total number of reviews
  * **rating** `number`: Average rating
  * **timezone** `string` (nullable): Business timezone
  * **website** `string` (nullable): Business website URL
  * **place\_id** `string`: Google Places place ID
  * **place\_link** `string`: Google Maps link to the place
  * **types** `array of strings`: Business category types
  * **price\_level** `string` (nullable): Price level indicator
  * **working\_hours** `any`: Business working hours (array or object)
  * **city** `string` (nullable): City where business is located
  * **is\_claimed** `boolean`: Whether business is claimed by owner
  * **verified** `boolean`: Whether business is verified
  * **photos** `array of objects`: Business photos
    * **src** `string`: Photo URL
    * **max\_size** `array of numbers` (nullable): Maximum size dimensions \[width, height]
    * **min\_size** `array of numbers`: Minimum size dimensions \[width, height]
  * **state** `string` (nullable): State/province
  * **description** `any`: Business description lines (array or other format)

**Example Usage:**

```json
{
  "query": "italian restaurants",
  "limit": 25,
  "country": "us",
  "lang": "en",
  "lat": 40.7128,
  "lng": -74.006,
  "offset": 0,
  "zoom": 14
}
```

***

## Location Reviews

Get reviews and ratings for businesses found through search.

### Get Reviews

Retrieve customer reviews for a specific business using its business\_id from search results. Returns detailed review information including ratings, text, reviewer info, and owner responses.

**Operation Type:** Query (Read)

**Parameters:**

* **business\_id** `string` (required): Business ID from search results
* **country** `string` (nullable): Country code (default: us)
* **lang** `string` (nullable): Language code (default: en)
* **limit** `number` (nullable): Maximum number of reviews (max 20, default 20)
* **cursor** `string` (nullable): Cursor for pagination from previous response
* **sort** `string` (nullable): Sort order for reviews. Options: "Relevant", "Newest", "Oldest", "HighestRated", "LowestRated". Defaults to "Relevant"
* **place\_id** `string` (nullable): Alternative place ID for getting reviews

**Returns:**

* **status** `string`: API response status
* **data** `array of objects`: Array of business reviews
  * **user\_name** `string` (nullable): Name of the reviewer
  * **user\_avatar** `string` (nullable): Profile photo URL of reviewer
  * **review\_rate** `number` (nullable): Review rating (1-5 stars)
  * **review\_text** `string` (nullable): Review content text
  * **review\_time** `string` (nullable): Human-readable review time (e.g., "5 months ago")
  * **review\_id** `string` (nullable): Unique review identifier
  * **business\_response\_text** `string` (nullable): Owner response to review
  * **user\_total\_reviews** `number` (nullable): Total reviews by this reviewer
  * **user\_total\_photos** `number` (nullable): Total photos by this reviewer
  * **iso\_date** `string` (nullable): ISO date of review publication
  * **review\_timestamp** `number` (nullable): Unix timestamp of review
  * **review\_link** `string` (nullable): Direct link to review on Google Maps
  * **review\_photos** `array of strings` (nullable): Array of photo URLs from review
  * **translations** `any` (nullable): Translated versions of review text (object or array)
  * **review\_cursor** `string` (nullable): Cursor for pagination
* **next\_page\_token** `string` (nullable): Token for next page of reviews

**Example Usage:**

```json
{
  "business_id": "0x89c25855c6480af3:0x8dd1102e7bd31339",
  "country": "us",
  "lang": "en",
  "limit": 10,
  "cursor": null,
  "sort": "Newest",
  "place_id": null
}
```

***

## Common Use Cases

**Business Intelligence and Market Research:**

* Research competitor locations, ratings, and customer feedback to understand market positioning
* Analyze business density and distribution across different geographic areas
* Study customer sentiment and review patterns for specific business types or locations

**Location-Based Services:**

* Find businesses near specific coordinates for mobile apps and location-based recommendations
* Search for businesses with specific attributes like price levels, ratings, or verification status
* Integrate business search functionality into mapping and directory applications

**Reputation Management:**

* Monitor customer reviews and ratings for business locations and competitor analysis
* Track review sentiment over time using sorting options and pagination for historical data
* Analyze owner responses to reviews to understand customer service approaches

**Content and Marketing:**

* Gather business photos and descriptions for content creation and marketing materials
* Research business hours, contact information, and website details for partnership opportunities
* Analyze review highlights and customer feedback to improve service offerings and messaging