1. Home
  2. 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
curl -G https://gmapsscraper.app/api/v1/search \
  -H "X-API-Key: demo" \
  --data-urlencode "query=dentists in Austin, TX"
Get a free API key Free tier: 50 results a month, no credit card. The public key 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
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.

Python
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.

Node.js
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.

MethodPathRequiredReturns
GET/api/v1/searchqueryUp to 500 places per request, 16 fields each
GET/api/v1/places/{place_id}place_idOne place, 20 fields
GET/api/v1/places/{place_id}/reviewsplace_idUp to 500 reviews per request, 7 fields each
GET/api/v1/places/{place_id}/photosplace_idUp to 100 photos per request, 5 fields each

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.

ParameterTypeRequiredDescriptionExample
querystringYesBusiness type and location in one stringdentists in Austin, TX
limitintegerNoPlaces to return: 1–25 on the free tier, 1–500 on paid plans; default 20100
languagestringNoLanguage for names, categories and addresses; default ende
regionstringNoTwo-letter country code that biases results toward one countryus
page_tokenstringNoToken from the previous response, to fetch the next pageeyJwIjoyfQ
without_websitebooleanNoReturn 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 websitestrue

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.

ParameterTypeRequiredDescriptionExample
place_idstring, in the pathYesGoogle Place ID from a search resultChIJb3aF0k21RIYR9xQ2nP8cV0E
languagestringNoLanguage for the name, category and address; default enfr
fieldsstringNoComma-separated fields to return; all fields by defaultphone,website

The response is one place object with the 16 fields described in the response schema, plus these four:

Response fieldTypeWhat it contains
business_statusstringOPERATIONAL, CLOSED_TEMPORARILY or CLOSED_PERMANENTLY
opening_hoursobject or nullOpening and closing times for each day of the week; null when Google Maps shows only part of the week
price_levelstringPrice range from $ to $$$$, when Google shows one
plus_codestringOpen 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.

ParameterTypeRequiredDescriptionExample
place_idstring, in the pathYesGoogle Place ID of the businessChIJb3aF0k21RIYR9xQ2nP8cV0E
limitintegerNoReviews to return, 1–500; default 50200
sortstringNonewest, most_relevant, highest_rating or lowest_rating; default newestlowest_rating
languagestringNoOnly return reviews written in this languageen
page_tokenstringNoToken from the previous response, to fetch the next pageeyJyIjo1MH0
Response fieldTypeWhat it contains
review_idstringStable ID, so you can skip reviews you already stored
ratingintegerStars the reviewer gave, from 1 to 5
review_textstringFull review text in its original language
published_atstringDate and time the review was posted, in UTC
languagestringLanguage code of the review text
owner_replystringThe business owner’s reply; empty when there is none
author_namestringReviewer’s public display name; personal data under GDPR
200 OK · reviews response (anonymized)
{
  "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.

ParameterTypeRequiredDescriptionExample
place_idstring, in the pathYesGoogle Place ID of the businessChIJb3aF0k21RIYR9xQ2nP8cV0E
limitintegerNoPhotos to return, 1–100; default 2010
max_widthintegerNoLargest width of the returned image URLs in pixels, 100–4800; default 1600800
Response fieldTypeWhat it contains
photo_idstringStable ID for the photo
photo_urlstringDirect image URL at or below max_width; it expires, so download rather than hotlink
widthintegerWidth of the image at that URL, in pixels
heightintegerHeight of the image at that URL, in pixels
uploaded_bystringowner or visitor
200 OK · photos response
{
  "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.

200 OK · search response (anonymized)
{
  "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"
}
FieldTypeWhat it contains
namestringBusiness name exactly as shown on Google Maps
place_idstringGoogle Place ID, the stable key for joins and refreshes
categorystringMain category chosen by the business
subcategoriesarraySecondary categories, when the business lists any
full_addressstringComplete address on one line, in local format
citystringCity or town, split out for filtering
postal_codestringZIP or postal code; a string, so leading zeros survive
statestringState, province or region
country_codestringTwo-letter ISO country code
phonestringPhone number in local format; empty when none is listed
websitestringWebsite linked from the listing
ratingnumberAverage star rating from 1.0 to 5.0
review_countinteger or nullTotal number of Google reviews; null when Google Maps shows a rating without the count
latitudenumberLatitude in decimal degrees (WGS84)
longitudenumberLongitude in decimal degrees (WGS84)
maps_urlstringLink 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:

429 Too Many Requests · Retry-After: 2
{
  "error": {
    "status": 429,
    "code": "rate_limited",
    "message": "Too many concurrent requests. Your plan allows 5 at a time.",
    "retry_after": 2
  }
}
StatusCodeMeaningWhat to do
400invalid_parameterA parameter is missing or out of rangeRead the message, which names the parameter
401invalid_keyThe key is missing, wrong or revokedCheck the X-API-Key header
402quota_exceededThis month’s results, or today’s free Place ID lookups, are used upUpgrade, or wait for the reset
404place_not_foundThe place ID no longer existsSearch by name again to get the new ID
429rate_limitedToo many requests at the same timeWait for Retry-After seconds, then retry
502upstream_errorGoogle Maps did not return the dataRetry with backoff; failed calls are not charged
504upstream_timeoutGoogle Maps did not answer in timeRetry 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 coverageEvery listing field in each response, plus up to 500 reviews and 100 photos per placeFields chosen per request with a field mask; up to 5 reviews per place
QuotaUp to 500 places per search; a monthly result allowance by planUp to 20 places per request and 60 per text query; per-minute quotas per project
Cost per callPer result returned, every field includedPer 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 dataYours to keep and export, within privacy lawMost content may not be stored; Place IDs can be kept, coordinates for up to 30 days
Credit cardNot needed for the free tierA 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.

PlanResultsPriceConcurrent requests
Free50 a month$01
Pay as you goAs many as you use, billed monthly$3.80 per 1,000 results5
Monthly plan5,000, 25,000 or 100,000 a month, shared with the web app$19, $49 or $149 a month5 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.