# Google Maps scraper API

> Search Google Maps the way a person does, “coffee shops in Boston” or “hotels near Fenway”, and get every place as JSON with its address, coordinates, rating, phone number and website.

Canonical page: https://scrapercompany.com/google-maps-api. Endpoints and prices checked against the API on 2026-11-11.

The Google Maps API returns the places Google Maps lists for a query: name, address, GPS coordinates, rating, phone, website and category, each with a place token. The detail call takes that token and returns the full record for one place, including its review count. The leads call searches one or more business types in a city and adds the emails and social profiles each business publishes on its own site.

Teams use it to build lead lists, map competitors around a hotel, enrich a CRM with phone numbers, websites and emails, or check that their own listing shows the right details. Results are localized by country and language.

Price: $6.00 per 1,000 calls with a credit pack, down to $2.00 on the Business plan. Failed requests cost 0 credits.

## What you get

- `name, category`: the business as Google Maps shows it
- `address, gps_coordinates`: street address with latitude and longitude
- `rating, reviews`: average rating and number of reviews
- `phone, website`: contact details when the place lists them
- `place_token`: id for the detail call

## Endpoints and price per call

| Endpoint | Method and path | What it returns | Credits per successful call | Price per call |
| --- | --- | --- | --- | --- |
| [Places search](https://scrapercompany.com/docs/reference/maps-search) | `POST /v1/maps/search` | Places for a query and location, up to 20 per call | 3 credits | $0.0037 on Starter, $0.0030 on Growth, $0.0024 on Scale, $0.0020 on Business |
| [Place detail](https://scrapercompany.com/docs/reference/maps-detail) | `POST /v1/maps/detail` | The full record for one place by its token | 3 credits | $0.0037 on Starter, $0.0030 on Growth, $0.0024 on Scale, $0.0020 on Business |
| [Business leads](https://scrapercompany.com/docs/reference/maps-leads) | `POST /v1/maps/leads` | Places for business types in a city, with emails and social links from each website | 6 credits | $0.0073 on Starter, $0.0060 on Growth, $0.0048 on Scale, $0.0040 on Business |

Pricing: free trial of 50 calls or 14 days, whichever ends first, no card needed; Starter $49/month for 40,000 credits; Growth $149/month for 150,000 credits; Scale $399/month for 500,000 credits; Business $999/month for 1,500,000 credits; credit packs $15 for 7,500, $60 for 35,000, $200 for 125,000 (valid 12 months). Failed requests (4xx or 5xx) and empty results cost 0 credits. https://scrapercompany.com/pricing

## Example

`POST /v1/maps/search`, 3 credits per successful call.

```bash
curl -X POST "https://api.scrapercompany.com/v1/maps/search" \
  -H "x-api-key: $SCRAPERCOMPANY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "q": "Hilton Chicago"
  }'
```

Response (trimmed):

```json
{
  "search_parameters": {
    "engine": "google_maps_search",
    "q": "Hilton Chicago",
    "gl": "us",
    "hl": "en"
  },
  "places": [
    {
      "place_token": "0x880e2c99242c7a2f:0x4de3d4bb09dba1",
      "name": "Hilton Chicago",
      "address": "720 S Michigan Ave, Chicago, IL 60605",
      "gps_coordinates": {
        "latitude": 41.872259199999995,
        "longitude": -87.624696
      },
      "rating": 4.3,
      "phone": "(312) 922-4400",
      "website": "https://www.hilton.com/en/hotels/chichhh-hilton-chicago/",
      "category": "Hotel"
    },
    {
      "place_token": "0x880e2c99242c7a2f:0x31660dda0c86665",
      "name": "The Chicago Hotel Collection Wrigleyville",
      "address": "844 W Addison St, Chicago, IL 60613",
      "gps_coordinates": {
        "latitude": 41.945531,
        "longitude": -87.654866
      },
      "rating": 4.1,
      "phone": "(773) 525-4700",
      "website": "https://www.chicago-hotel-collection.com/",
      "category": "Hotel"
    }
  ],
  "total": 2,
  "meta": {
    "source": "google_maps",
    "elapsed_s": 0.712
  }
}
```

## Fields in the response

Arrays show their first item; every item has the same fields.

| Field | Type | Example | What it is |
| --- | --- | --- | --- |
| `places` | array |  |  |
| `places[].place_token` | string | `"0x880e2c99242c7a2f:0x4de3d4bb09dba1"` |  |
| `places[].name` | string | `"Hilton Chicago"` | Name as the site shows it. |
| `places[].address` | string | `"720 S Michigan Ave, Chicago, IL 60605"` | Postal address as the site shows it. |
| `places[].gps_coordinates` | object |  | Latitude and longitude in decimal degrees. |
| `places[].rating` | number | `4.3` | Average rating on the site’s own scale. |
| `places[].phone` | string | `"(312) 922-4400"` |  |
| `places[].website` | string | `"https://www.hilton.com/en/hotels/chichh…"` |  |
| `places[].category` | string | `"Hotel"` |  |
| `total` | integer | `2` | Total for the whole stay or request, in currency. |
| `meta` | object |  | About the call: what was asked for and how big the answer is. |

## Inputs

| Input | Type | Required | What it does |
| --- | --- | --- | --- |
| `q` | string | yes | Maps search query. min length 1, max length 200. |
| `gl` | string | no | Country market. Default us. |
| `hl` | string | no | Language. Default en. |

## Your first call in three steps

1. **Get an API key.** Create an account and verify your email, then copy a key from the dashboard. The free trial is 50 calls or 14 days, whichever ends first, no card needed.
2. **Send POST /v1/maps/search.** Put the key in the `x-api-key` header and pass `q`. Every other input is optional and listed above.
3. **Read the JSON.** The answer is one JSON object with `places`, `total` and `meta`, typed and named the same way on every call. A failed call costs 0 credits, so retrying is free.

## Limits and coverage

- Where it works: Worldwide
- A lead email is marked valid, risky-role, invalid or unverified from the domain's MX records only. The check does not prove the mailbox exists.
- A partial or empty lead list is free. An empty places page is free.

## Is it legal to scrape Google Maps?

**Public pages only.** The API reads what Google Maps shows anyone who opens the page without signing in. It uses no account and opens nothing behind a paywall.

**Facts are not the same as content.** A price on a date, a rating or a count is a fact, and copyright does not protect facts. Review text, photos, descriptions and transcripts belong to their authors or the site. Counting, scoring or summarising them is a different use from republishing them, and republishing usually needs permission.

**Databases have their own right in the EU and UK.** Whoever invested in building a database there can stop others taking a substantial part of it, and repeated extraction of small parts can add up to a substantial part. Collect the fields and dates you need, not a copy of Google Maps.

**Personal data is yours to handle.** Business listings can name owners and carry a phone number or email that belongs to a person, and reviews carry reviewer names. Using those for cold outreach also brings in marketing rules, such as the ePrivacy rules in the EU, PECR in the UK, and CAN-SPAM and the TCPA in the US. If you keep it, the GDPR and UK GDPR apply to people in Europe and the UK, and other places have their own privacy laws: you need a lawful basis, must tell people you hold their data unless an exemption applies, should collect no more than you need, and should delete it on a schedule. The simplest route is not to keep it: drop names and handles before you store anything. A hashed name is still personal data.

**The site’s terms, and ours.** The terms of use of Google Maps may limit automated access to it or reuse of its data. Our Terms make you responsible for how you use the data you collect, for following the terms of the sites it comes from, for data protection law, and for having the rights you need.

This is general information, not legal advice. For a specific use, ask a lawyer where you operate. Google Maps is a trademark of its owner. ScraperCompany is independent: not affiliated with or endorsed by Google Maps, and this is not an official Google Maps API.
Our Terms: https://scrapercompany.com/terms#data-use

## FAQ

### How is this different from the Google Places API?

Google’s Places API is billed per field group and returns what Google chooses to expose to API customers. This API returns what the Google Maps results page shows for a query, as one JSON record per place. Places search and place detail are 3 credits a call. Business leads, which also read each website for published emails, are 6 credits, and a partial or empty result is free.

### Can I search a specific city or neighbourhood?

Yes. Put the place in the query, for example “restaurants in Back Bay Boston”, and set the country and language with gl and hl.

### Does it return reviews?

Places carry their rating and review count. For hotel review text, use the Google Hotels reviews endpoint, which returns the reviews themselves.

### Does the leads call verify that an inbox exists?

No. email_status is an MX check of the domain only: valid means the domain has MX records and the address is not a role inbox, risky-role means a role inbox such as info@ or contact@, invalid means the domain has no MX records, and unverified means the lookup failed or verify_emails was off. It never claims the mailbox itself exists.

### Do failed requests cost credits?

No. A failed or blocked call (any 4xx or 5xx response) costs 0 credits, and so does a search page that comes back empty. You pay only for successful results.

### How do I get an API key?

Create an account on the sign-up page and verify your email. You get a free trial of 50 calls or 14 days, whichever ends first, no card needed on the travel endpoints (hotels, vacation rentals, flights, reviews) and 10 calls to the other sources; for everything else, and after the trial, buy a credit pack (from $15) or pick a plan. You create and rotate keys yourself in the dashboard.

## Read next

- [Maps search reference](https://scrapercompany.com/docs/reference/maps-search)
- [Maps leads reference](https://scrapercompany.com/docs/reference/maps-leads)
- [Vertical engines guide](https://scrapercompany.com/docs/guides/vertical-engines)
- [Google Hotels API](https://scrapercompany.com/google-hotels-api)
- [Google Maps](https://scrapercompany.com/docs/guides/vertical-engines#maps)
- [All APIs](https://scrapercompany.com/apis.md)
