Name: Google Maps Business API: Places, Phones and Ratings
Brand: benthepythondev
SKU: api-benthepythondev-google-maps-business
Availability: InStock
Author: API Market

# Google Maps Business API

## Overview

The Google Maps Business API returns Google Maps businesses for any search and place as JSON. One endpoint takes a query such as `dentist` and a location such as `Austin, TX`, and returns each place's name, categories, phone, website, address in parts, coordinates, rating, review count, opening hours, place ID, photo count and a 0 to 100 lead score.

It is built for sales teams and agencies building local lead lists, local SEO tools, market researchers mapping businesses in an area and AI agents that need local business data. Results stay inside the place you name, and filters for rating, review count, website and closed places run before anything is returned.

## Features

*   **1 endpoint**: search Google Maps places by query and location.
*   **Contact data**: phone, international phone, website and domain.
*   **Place details**: address parts, coordinates, hours, categories, rating and reviews.
*   **Location boundary**: places outside the named area are dropped.
*   **Filters**: minimum rating and reviews, website required and skip closed places.
*   **Rate limit**: up to 10 requests per second.

## Use Cases

*   **Local lead lists**: find businesses with phones and websites in a city.
*   **Local SEO**: compare ratings and reviews of competitors.
*   **Market mapping**: count businesses by category in an area.
*   **AI agents**: answer local business questions.

## API Documentation

### Base URL

All requests go through the API.market gateway at this base URL:

```
https://prod.api.market/api/v1/benthepythondev/google-maps-business
```

### Authentication

Every request needs your API.market key in the `x-api-market-key` header:

```
x-api-market-key: YOUR_API_KEY
```

Replace `YOUR_API_KEY` with your actual API key.

### Endpoints

#### 1. Search places

Returns Google Maps places for any search and location: name, phone, website, address parts, coordinates, rating, review count, opening hours, categories, place id and a lead score. Up to 20 results per request, as JSON.

**Method:** `POST`

**Endpoint:** `/`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| query | body | What to search for on Google Maps, as you would type it there: a kind of business ("dentist", "coffee shop"), a brand or a business name. Searched in the location below. | string | No | - | - |
| location | body | City, district, state or country to search in, for example "San Francisco, CA", "Mitte, Berlin" or "Texas". | string | No | - | - |
| queries | body | Several search queries for one request. Each query is searched in each location, and a place found by two searches is saved once. | array of string | No | - | - |
| locations | body | Several locations for one request, for example a list of cities. Each query is searched in each of them. | array of string | No | - | - |
| maxResults | body | Places to return for each search (each query in each location). A request returns 20 places at most. | integer | No | 10 | 20 |
| startUrls | body | Google Maps place links, place ids (ChIJ…), feature ids (0x…:0x…) or Google Maps search links. Each place is read from its own page, every link is read regardless of the limit above. A search link is run as a search; a link with a map position (…/@37.76,-122.41,15z) searches that part of the map. | array of string | No | - | - |
| mode | body | "search" runs the queries and reads the links. "direct_urls" reads only the links and ignores the query fields. | string | No | search | - |
| minRating | body | Save only places with at least this star rating (1.0 to 5.0). Places without a rating are left out. | number | No | - | 5 |
| minReviews | body | Save only places with at least this many reviews. | integer | No | - | - |
| websiteFilter | body | "has_website" saves only places with a website, "no_website" only places without one (prospects for web design and local marketing). | string | No | any | - |
| skipClosedPlaces | body | Leave out places Google marks as permanently closed. `skipClosed` is read as well. | boolean | No | false | - |
| requireWebsite | body | Save only places that list a website, the same as websiteFilter "has_website". | boolean | No | false | - |
| includeReviews | body | Reads each place's own page as well: price range, every group of Google's "About" tab, the number of 1 to 5 star reviews and the reviews Google shows a visitor on the overview (eight at most, with author, rating, text and date). One more request per place, about four places a second. Without it a row has what Google's result list carried. | boolean | No | false | - |
| maxReviews | body | Reviews to keep per place when reviews are included. Google shows a visitor eight at most. | integer | No | 10 | 100 |
| includePhotos | body | Adds `photos`: the photo links in Google's record of the place, between 1 and about 20. The main photo is always in `image_url`. | boolean | No | false | - |
| includeLeadScore | body | Adds a score from 0 to 100 computed from the row itself: website and phone present, rating, number of reviews, opening hours, photos. | boolean | No | true | - |
| scrapeContacts | body | Reads each place's website (home, contact, Kontakt, Impressum and about pages) and adds primary_email, emails, socials and has_contact_form to the row. Included in the place price, no extra event. Adds a few seconds per place; places without a website get empty fields. | boolean | No | false | - |
| language | body | Language of categories, opening hours and descriptions, as a language code: en, de, fr, es, it, pt-BR, ja. | string | No | en | - |
| countryCode | body | Two-letter country code Google is told the visitor is in. It decides the format of addresses and phone numbers: with "us" a US phone is "(415) 772-9060", a German one "+49 30 81455310"; with "de" the German one is "030 81455310". | string | No | us | - |
| excludePlaceUrls | body | Skip these places, given as long Google Maps place links. | array of string | No | - | - |
| excludePlaceIds | body | Skip these places, given as place ids (ChIJ…), numeric CIDs or feature ids (0x…:0x…). | array of string | No | - | - |

**Example Request:**

```bash
curl -X POST 'https://prod.api.market/api/v1/benthepythondev/google-maps-business/' \
  -H 'x-api-market-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"query": "restaurants", "location": "San Francisco, CA", "maxResults": 5}'
```

**Example Response (201 Created, trimmed):**

Long lists are cut to their first items and long text is shortened.

```json
[
  {
    "name": "Rich Table",
    "rating": 4.7,
    "review_count": 1634,
    "address": "199 Gough St, San Francisco, CA 94102",
    "phone": "(415) 355-9085",
    "website": "http://richtablesf.com/",
    "categories": [
      "New American restaurant",
      "Californian restaurant"
    ],
    "has_hours": true,
    "plus_code": "QHFG+WV San Francisco, CA",
    "url": "https://www.google.com/maps/place/Rich+Table/data=!4m7!3m6!1s0x8085809f40b8fd87:0x7b5e765335d416ff!8m2!3d37.7748657!4d-122.4228497!16s%2Fg%2F11h18mfkk!19sChIJh_24QJ-AhYAR_xbUNVN2Xns",
    "lead_score": 90,
    "place_id": "ChIJh_24QJ-AhYAR_xbUNVN2Xns",
    "cid": "8889672814233392895",
    "feature_id": "0x8085809f40b8fd87:0x7b5e765335d416ff",
    "kgmid": "/g/11h18mfkk",
    "category": "New American restaurant",
    "description": "Californian fare from local ingredients, served in a salvaged-barn-wood space with an open kitchen.",
    "price": null,
    "latitude": 37.7748657,
    "longitude": -122.4228497,
    "neighborhood": "Lower Haight",
    "street": "199 Gough St",
    "city": "San Francisco",
    "state": "California",
    "postal_code": "94102",
    "country_code": "US",
    "phone_international": "+1 415-355-9085",
    "domain": "richtablesf.com",
    "opening_hours": [
      {
        "day": "Monday",
        "hours": "5–10 PM"
      },
      {
        "day": "Tuesday",
        "hours": "5–10 PM"
      }
    ],
    "timezone": "America/Los_Angeles",
    "permanently_closed": false,
    "image_url": "https://lh3.googleusercontent.com/grass-cs/AABkmLflU1viTDnlnFnQn19PUxPjfJ0le2NjWil_abvRVd6frE3jtSl6r4g0MlMEbDd2fGgx35j-7XORDPWC_wnyRx0K4dSJdKGfbsMKPecj2l2EoONmaoDg66JV4UCzKQTbwyRENrTTuA=w1200-h900-k-no",
    "photo_count": 4124,
    "attributes": {
      "Accessibility": [
        "Wheelchair accessible entrance",
        "Wheelchair accessible restroom"
      ]
    },
    "query": "restaurants San Francisco, CA",
    "rank": 1,
    "scraped_at": "2026-10-27T07:26:57.292178+00:00"
  },
  {
    "name": "Lazy Bear",
    "rating": 4.7,
    "review_count": 1214,
    "address": "3416 19th St, San Francisco, CA 94110",
    "phone": "(415) 874-9921",
    "website": "http://www.lazybearsf.com/",
    "categories": [
      "New American restaurant",
      "Fine dining restaurant"
    ],
    "has_hours": true,
    "plus_code": "QH6J+54 San Francisco, CA",
    "url": "https://www.google.com/maps/place/Lazy+Bear/data=!4m7!3m6!1s0x808f7e3c8b5b7e93:0x7e267bfa507a2912!8m2!3d37.7604119!4d-122.41971559999999!16s%2Fg%2F11b63f5_6r!19sChIJk35bizx-j4AREil6UPp7Jn4",
    "lead_score": 90,
    "place_id": "ChIJk35bizx-j4AREil6UPp7Jn4",
    "cid": "9090089212916148498",
    "feature_id": "0x808f7e3c8b5b7e93:0x7e267bfa507a2912",
    "kgmid": "/g/11b63f5_6r",
    "category": "New American restaurant",
    "description": "The revered pop-up gets a permanent setting with this midcentury space serving New American cuisine.",
    "price": null,
    "latitude": 37.7604119,
    "longitude": -122.41971559999999,
    "neighborhood": "Mission District",
    "street": "3416 19th St",
    "city": "San Francisco",
    "state": "California",
    "postal_code": "94110",
    "country_code": "US",
    "phone_international": "+1 415-874-9921",
    "domain": "lazybearsf.com",
    "opening_hours": [
      {
        "day": "Monday",
        "hours": "Closed"
      },
      {
        "day": "Tuesday",
        "hours": "5–10 PM"
      }
    ],
    "timezone": "America/Los_Angeles",
    "permanently_closed": false,
    "image_url": "https://lh3.googleusercontent.com/grass-cs/AABkmLdAsm2msfZq84SjJ78q6yvgN47uFR5psUOkyL0jfMLjSgOe7JsD0Hg0nZ8SscZW32tL8f8dnqIKCBxj6l0kXVzojN6dABdTVeXGvkyRsiGwmSgVoIfdEvTKYwYLT3AqOouJ8ZBu=w1200-h900-k-no",
    "photo_count": 7173,
    "attributes": {
      "Accessibility": [
        "Wheelchair accessible entrance",
        "Wheelchair accessible restroom"
      ]
    },
    "query": "restaurants San Francisco, CA",
    "rank": 2,
    "scraped_at": "2026-10-27T07:26:57.292178+00:00"
  }
]
```

## Status Codes

| Code | Status | Description |
|---|---|---|
| 201 | Created | The request ran and the body holds the results. |
| 400 | Bad Request | The body is not valid JSON or a filter value has the wrong type. |
| 401 | Unauthorized | The `x-api-market-key` header is missing, invalid or expired. |
| 403 | Forbidden | Your subscription does not include this endpoint. |
| 404 | Not Found | The path, or the item you asked for, does not exist. |
| 429 | Too Many Requests | You sent more than 10 requests per second, or you used all 50 calls of the Free trial plan. |
| 500 | Internal Server Error | Something failed on the provider side. Retry after a short delay. |
| 503 | Service Unavailable | The service or its data source is temporarily unavailable. Retry with backoff. |

## Rate Limits

You can send up to 10 requests per second. Free includes 50 calls (a 7-day trial), Basic includes 1,500 calls a month for $9.99, Pro includes 12,000 calls a month for $29.99 and Mega includes 50,000 calls a month for $99.99. Requests above the limit return `429 Too Many Requests`; throttle your requests, back off before retrying, and honour the `Retry-After` header when it is present.

## FAQ

*   **Do I need a Google API key?**
    No. Your API.market key is all you need.

*   **Why are places outside my city missing?**
    The location is matched to its boundary and places outside it are dropped.

*   **What is `lead_score`?**
    A 0 to 100 score computed from the row: website and phone present, rating, number of reviews, opening hours and photos.

## Contact Us

If you have any questions or need assistance, you can reach out to us through the embedded chat on the bottom right corner of the page or send an email to hello@magicapi.com.


Google Maps businesses as JSON: phone, website, address, rating, review count, hours, place id and lead score, kept inside the city you name.

Google Maps Business API: Places, Phones and Ratings

Free