Google Maps scraper API
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.
- Data from Google Maps
$6.00 per 1,000 calls with a credit pack, down to $2.00 on the Business plan
7,500 credits, one-time. No subscription. Failed calls are free. The free trial covers the travel endpoints and 10 calls to the rest.
Endpoints and prices checked against the API on .
All Google and SERP APIsThe 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.
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
One call, structured JSON
POST /v1/maps/search, 3 credits per successful call.
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"
}'{
"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
}
}Every field, documented before you buy
What one POST /v1/maps/search call returns: 11 fields with their type and a value from the example above, then every input the call takes.
In the response
| 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. |
Arrays show their first item; every item has the same fields. Full schema in the API reference
In the request
| 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. |
Endpoints and price per call
Credits per successful call, and what 1,000 calls cost: from a credit pack down to the Business plan. Failed requests cost nothing.
| Endpoint | What it returns | Credits | Per 1,000 calls |
|---|---|---|---|
| Places search POST /v1/maps/search | Places for a query and location, up to 20 per call | 3 credits | $6.00 – $2.00 |
| Place detail POST /v1/maps/detail | The full record for one place by its token | 3 credits | $6.00 – $2.00 |
| Business leads POST /v1/maps/leads | Places for business types in a city, with emails and social links from each website | 6 credits | $12.00 – $4.00 |
Your first call in three steps
- 01
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.
- 02
Send POST /v1/maps/search
Put the key in the
x-api-keyheader and passq. Every other input is optional and listed above. - 03
Read the JSON
The answer is one JSON object with
places,totalandmeta, 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?
It depends on what you collect and what you do with it. Here is what the API does, and what stays with you once the data is yours.
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.
Frequently asked questions
Read next
Guides
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.
More APIs on the same key
All APIsSearch a destination, open a property, pull a whole price calendar and read its reviews. Every Google Hotels result as JSON, with base price, taxes, fees and total kept separate.
Every itinerary Google Flights shows for a route and date, with legs, layovers, emissions and price insights, then the return leg and the booking options behind the fare you pick.
Organic results, People Also Ask, the AI Overview and related searches for any query, localized to a country or a city, as JSON. Autocomplete and Google News on the same key.
Send a URL, get the page back as HTML, markdown or text. If an attempt does not return the page, the request is tried again automatically, and you pay only for a page that comes back with content.
Start with 50 free calls
Create an account and verify your email: your own API keys and a free trial of 50 calls or 14 days, whichever ends first, no card needed. Then buy a credit pack from $15 or pick a plan from $49 a month.
7,500 credits, one-time. No subscription. Or try it free: 50 calls, no card.
- See pricingPlans, packs and every price
- Talk to salesVolume, custom terms, invoices
- Read the quickstartFirst call in five minutes