- Home
- API
Google Maps Scraper API
One REST request returns places, reviews, phone numbers and websites from Google Maps.
The Google Maps scraper API turns a search such as “dentists in Austin, TX” into clean JSON you can load straight into a database, a CRM or a spreadsheet. Copy the request below and run it in your terminal. It works before you sign up.
curl -G https://gmapsscraper.app/api/v1/search \
-H "X-API-Key: demo" \
--data-urlencode "query=dentists in Austin, TX"
demo returns sample data.
Unofficial API. Not affiliated with, endorsed by, or sponsored by Google LLC. Google Maps is a trademark of Google LLC.
Quickstart
Every call to the Google Maps scraper API is a plain HTTPS GET request with your key in the X-API-Key header. Here is the same search in cURL, Python and Node.js. Each one runs as written with the public test key demo, which returns fixed sample data, so you can check the shape of the response first and swap in your own key when you want live results.
curl -G https://gmapsscraper.app/api/v1/search \
-H "X-API-Key: demo" \
--data-urlencode "query=dentists in Austin, TX" \
-d limit=20
cURL ships with macOS, Linux and Windows 10 or later, so this is the quickest way to test a key. To get the next page, send the same request again with the page_token from the response.
import requests
resp = requests.get(
"https://gmapsscraper.app/api/v1/search",
headers={"X-API-Key": "demo"},
params={"query": "dentists in Austin, TX", "limit": 20},
timeout=60,
)
resp.raise_for_status()
for place in resp.json()["results"]:
print(place["name"], place["phone"], place["place_id"])
Needs Python 3.8 or later and the requests library, installed with pip install requests. The loop prints one line per business; replace the print call with a CSV writer or a database insert.
const params = new URLSearchParams({query: 'dentists in Austin, TX', limit: '20'});
const res = await fetch(`https://gmapsscraper.app/api/v1/search?${params}`, {
headers: {'X-API-Key': 'demo'},
});
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const {results} = await res.json();
for (const p of results) console.log(p.name, p.phone, p.place_id);
Runs on Node.js 18 or later, which includes fetch, with no packages to install. Save it as an .mjs file so the top-level await works.
From here, pass any place_id in the results to the place details endpoint, pull its reviews or photos, or read the response schema below to see what every field contains.
Endpoints & Parameters
There are four endpoints, all under https://gmapsscraper.app/api/v1/. Each one takes a GET request, authenticates with the X-API-Key header and returns UTF-8 JSON. Paths are stable: once an endpoint is published, its path and field names do not change.
Create and rotate keys in your dashboard, and keep them on your server; a key in browser code can be copied by anyone. Every list endpoint pages the same way: read next_page_token from the response and send it back as page_token until it is missing.
| Method | Path | Required | Returns |
|---|---|---|---|
| GET | /api/v1/search | query | Up to 500 places per request, 16 fields each |
| GET | /api/v1/places/{place_id} | place_id | One place, 20 fields |
| GET | /api/v1/places/{place_id}/reviews | place_id | Up to 500 reviews per request, 7 fields each |
| GET | /api/v1/places/{place_id}/photos | place_id | Up to 100 photos per request, 5 fields each |
GET /api/v1/search
Finds the businesses that match a keyword in a place, the same search you would type into Google Maps. Results come back in Google Maps order, with a next_page_token whenever there are more to fetch.
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
query | string | Yes | Business type and location in one string | dentists in Austin, TX |
limit | integer | No | Places to return: 1–25 on the free tier, 1–500 on paid plans; default 20 | 100 |
language | string | No | Language for names, categories and addresses; default en | de |
region | string | No | Two-letter country code that biases results toward one country | us |
page_token | string | No | Token from the previous response, to fetch the next page | eyJwIjoyfQ |
without_website | boolean | No | Return only places with no website or only a social profile. Checks up to 3 listings per place requested and adds scanned, the number checked, to the response; only returned places are charged. See businesses without websites | true |
GET /api/v1/places/{place_id}
Returns every field for one place: everything in a search result plus opening hours, business status, price level and plus code. Use it to refresh a record you already store, keyed by its place ID.
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
place_id | string, in the path | Yes | Google Place ID from a search result | ChIJb3aF0k21RIYR9xQ2nP8cV0E |
language | string | No | Language for the name, category and address; default en | fr |
fields | string | No | Comma-separated fields to return; all fields by default | phone,website |
The response is one place object with the 16 fields described in the response schema, plus these four:
| Response field | Type | What it contains |
|---|---|---|
business_status | string | OPERATIONAL, CLOSED_TEMPORARILY or CLOSED_PERMANENTLY |
opening_hours | object or null | Opening and closing times for each day of the week; null when Google Maps shows only part of the week |
price_level | string | Price range from $ to $$$$, when Google shows one |
plus_code | string | Open Location Code for places without a street address |
GET /api/v1/places/{place_id}/reviews
Returns the public reviews for one place, newest first unless you choose another order. Each review includes its star rating, text, date and language, plus the owner’s reply when there is one.
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
place_id | string, in the path | Yes | Google Place ID of the business | ChIJb3aF0k21RIYR9xQ2nP8cV0E |
limit | integer | No | Reviews to return, 1–500; default 50 | 200 |
sort | string | No | newest, most_relevant, highest_rating or lowest_rating; default newest | lowest_rating |
language | string | No | Only return reviews written in this language | en |
page_token | string | No | Token from the previous response, to fetch the next page | eyJyIjo1MH0 |
| Response field | Type | What it contains |
|---|---|---|
review_id | string | Stable ID, so you can skip reviews you already stored |
rating | integer | Stars the reviewer gave, from 1 to 5 |
review_text | string | Full review text in its original language |
published_at | string | Date and time the review was posted, in UTC |
language | string | Language code of the review text |
owner_reply | string | The business owner’s reply; empty when there is none |
author_name | string | Reviewer’s public display name; personal data under GDPR |
{
"place_id": "ChIJb3aF0k21RIYR9xQ2nP8cV0E",
"count": 50,
"results": [
{
"review_id": "r_7Hq2kLm9",
"rating": 5,
"review_text": "Booked the same day and the cleaning was painless.",
"published_at": "2026-10-18T14:02:11Z",
"language": "en",
"owner_reply": "Thank you, see you in six months!",
"author_name": "J. D."
}
],
"next_page_token": "eyJyIjo1MH0"
}
GET /api/v1/places/{place_id}/photos
Returns photo URLs for one place, with each photo’s size and whether the owner or a visitor uploaded it. Photos belong to the people who took them, so check the rights before you publish one anywhere else.
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
place_id | string, in the path | Yes | Google Place ID of the business | ChIJb3aF0k21RIYR9xQ2nP8cV0E |
limit | integer | No | Photos to return, 1–100; default 20 | 10 |
max_width | integer | No | Largest width of the returned image URLs in pixels, 100–4800; default 1600 | 800 |
| Response field | Type | What it contains |
|---|---|---|
photo_id | string | Stable ID for the photo |
photo_url | string | Direct image URL at or below max_width; it expires, so download rather than hotlink |
width | integer | Width of the image at that URL, in pixels |
height | integer | Height of the image at that URL, in pixels |
uploaded_by | string | owner or visitor |
{
"place_id": "ChIJb3aF0k21RIYR9xQ2nP8cV0E",
"count": 10,
"results": [
{
"photo_id": "p_3Xv81QaZ",
"photo_url": "https://gmapsscraper.app/api/v1/media/p_3Xv81QaZ?w=800",
"width": 800,
"height": 600,
"uploaded_by": "owner"
}
]
}
Response Schema
Every successful response uses the same envelope: your query echoed back, a count, a results array and a next_page_token when another page exists. This is a real search response, trimmed to one place and anonymized, followed by what each field contains. Field names match the CSV export exactly.
{
"query": "dentists in Austin, TX",
"count": 20,
"results": [
{
"name": "Blue Fern Dental",
"place_id": "ChIJb3aF0k21RIYR9xQ2nP8cV0E",
"category": "Dentist",
"subcategories": ["Cosmetic dentist", "Emergency dental service"],
"full_address": "4815 Cedar Hollow Rd, Austin, TX 78745, United States",
"city": "Austin",
"postal_code": "78745",
"state": "TX",
"country_code": "US",
"phone": "(512) 555-0142",
"website": "https://www.bluefern-dental.example",
"rating": 4.8,
"review_count": 312,
"latitude": 30.2071,
"longitude": -97.8011,
"maps_url": "https://www.google.com/maps/place/?q=place_id:ChIJb3aF0k21RIYR9xQ2nP8cV0E"
}
],
"next_page_token": "eyJwIjoyfQ"
}
| Field | Type | What it contains |
|---|---|---|
name | string | Business name exactly as shown on Google Maps |
place_id | string | Google Place ID, the stable key for joins and refreshes |
category | string | Main category chosen by the business |
subcategories | array | Secondary categories, when the business lists any |
full_address | string | Complete address on one line, in local format |
city | string | City or town, split out for filtering |
postal_code | string | ZIP or postal code; a string, so leading zeros survive |
state | string | State, province or region |
country_code | string | Two-letter ISO country code |
phone | string | Phone number in local format; empty when none is listed |
website | string | Website linked from the listing |
rating | number | Average star rating from 1.0 to 5.0 |
review_count | integer or null | Total number of Google reviews; null when Google Maps shows a rating without the count |
latitude | number | Latitude in decimal degrees (WGS84) |
longitude | number | Longitude in decimal degrees (WGS84) |
maps_url | string | Link that opens the place on Google Maps |
Errors use standard HTTP status codes and one JSON shape, so a single handler covers all of them. This is the response when you send more requests at once than your plan allows:
{
"error": {
"status": 429,
"code": "rate_limited",
"message": "Too many concurrent requests. Your plan allows 5 at a time.",
"retry_after": 2
}
}
| Status | Code | Meaning | What to do |
|---|---|---|---|
| 400 | invalid_parameter | A parameter is missing or out of range | Read the message, which names the parameter |
| 401 | invalid_key | The key is missing, wrong or revoked | Check the X-API-Key header |
| 402 | quota_exceeded | This month’s results, or today’s free Place ID lookups, are used up | Upgrade, or wait for the reset |
| 404 | place_not_found | The place ID no longer exists | Search by name again to get the new ID |
| 429 | rate_limited | Too many requests at the same time | Wait for Retry-After seconds, then retry |
| 502 | upstream_error | Google Maps did not return the data | Retry with backoff; failed calls are not charged |
| 504 | upstream_timeout | Google Maps did not answer in time | Retry with a smaller limit; failed calls are not charged |
How It Compares to the Google Places API
Google’s Places API is the official way to show live place data inside an app. This API is a third-party scraping service with no connection to Google, built for a different job: getting lists of businesses into your own systems.
| This API (third-party, not affiliated with Google) | Google Places API (New) | |
|---|---|---|
| Field coverage | Every listing field in each response, plus up to 500 reviews and 100 photos per place | Fields chosen per request with a field mask; up to 5 reviews per place |
| Quota | Up to 500 places per search; a monthly result allowance by plan | Up to 20 places per request and 60 per text query; per-minute quotas per project |
| Cost per call | Per result returned, every field included | Per request, by field tier: phone, website, rating and hours bill at the Enterprise rate, $35 per 1,000 Text Search requests after 1,000 free a month |
| Terms on storing data | Yours to keep and export, within privacy law | Most content may not be stored; Place IDs can be kept, coordinates for up to 30 days |
| Credit card | Not needed for the free tier | A billing account with a card is required, even for free usage |
Places API figures: Google Maps Platform pricing and Places API policies, checked on [date of final check].
Rate Limits & Pricing
You pay for results returned, not for requests or fields, and failed calls are free. A monthly plan’s results are shared with the web app, so one subscription covers both. Every plan uses the same key and the same endpoints; only the allowance and the number of requests you can run at the same time change.
| Plan | Results | Price | Concurrent requests |
|---|---|---|---|
| Free | 50 a month | $0 | 1 |
| Pay as you go | As many as you use, billed monthly | $3.80 per 1,000 results | 5 |
| Monthly plan | 5,000, 25,000 or 100,000 a month, shared with the web app | $19, $49 or $149 a month | 5 to 20, by plan |
A search returns at most 25 places on the free tier and 500 on paid plans. Allowances reset on the 1st of each month, and unused free results do not carry over. Past the limit, requests return 402 until you upgrade or the month resets. Full details: API pricing.
Compliance
What the API collects, what it never does, and what you are responsible for once the data is yours. This section is written so you can forward it to your legal team.
- Public data only. The API reads what Google Maps shows any visitor who is not signed in. It never logs in to a Google account and never touches private data.
- Live reads, no resale. Each request reads Google Maps when you make it. We don’t sell a pre-built database of businesses.
- Personal data. Listings can include personal data, such as a sole trader’s name and phone number, and reviews include reviewer names, returned only when you call the reviews endpoint. Under GDPR and CCPA you need a lawful basis to store and use them, and you must honor opt-out and deletion requests.
- Caching. Refresh stored records every 30 to 90 days, keep place_id as the key, and remove places whose business status becomes permanently closed.
- Not affiliated with Google. This is a third-party scraping service. It is not part of Google Maps Platform and is not endorsed by Google.
FAQ
Last updated: November 1, 2026
Is the API free?
Yes, up to a point. The free tier gives you 50 results a month with no credit card, and the public test key demo returns sample data without any sign-up. When you need more, your monthly plan’s results work here too, or you can pay as you go per result returned. Unused free results do not carry over to the next month.
Is there a Python SDK?
Yes. The open-source Python SDK on GitHub wraps all four endpoints and handles paging, retries and rate limits for you. You can also call the API with the requests library alone, as the Quickstart shows. A Node.js example repository and ready-made n8n and Make templates sit alongside it.
How is this different from the official Google Places API?
The Places API is Google’s own service for showing live place data in apps. It bills per request by field tier and limits what you may store. This API is an unofficial third-party scraper: one request returns every field, you pay per result, and the data is yours to export. Many teams use both, joined by place ID.
Can I get reviews?
Yes. The reviews endpoint returns up to 500 public reviews per request, each with its rating, text, date, language and any owner reply. Sort by newest, most relevant, highest or lowest rating, and use the page token to fetch more. Each review returned counts as one result against your allowance.
Can I get blocked or banned?
No. Requests run on our infrastructure, not from your IP address or your Google account, so there is nothing on your side for Google to block. If Google Maps slows down or refuses a request, we retry it automatically, and a request that still fails returns an error and is not charged.
Does it support bulk requests?
Yes. One search returns up to 500 places on paid plans, and you can run up to 20 requests at the same time, depending on your plan. To enrich a list you already have, loop over its place IDs with the place details endpoint. The Python SDK does this for you, with concurrency built in.
Start with 50 free results a month
No credit card required. Rather click than code? Try the Google Maps scraper in your browser.
Check your inbox — your API key is on its way.