Maps Data

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

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:

{
  "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:

{
  "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