Google Maps Reviews API
The ScrapeMapsAPI Google Maps Reviews API returns the reviews of any place on Google Maps as JSON: all of them, not the 5 that the official Places API gives you. Each review comes with its rating, date, original text and language, Google's translation, the owner's reply, photos and structured answers such as the price per person. Sort by relevance, newest, highest or lowest rating, keep only the reviews written in one language, and page to the end of the list with a cursor. One GET request per page, with nothing but an API key.
No credit card needed. One API key works on every endpoint.
Quick example
/v1/places/{place}/reviewsSend your key in the X-API-Key header (or as Authorization: Bearer) to the base URL https://api.scrapemapsapi.com. The official SDKs wrap the same call: pip install scrapemapsapi or npm install scrapemapsapi.
curl "https://api.scrapemapsapi.com/v1/places/ChIJ8cLgoQNUKhMReGlaTjwrH40/reviews?sort=newest&limit=20" \
-H "X-API-Key: key_your_api_key"Sample response
A successful call answers with HTTP 200: the reviews in data, the cursor of the next page in pagination and the cost of the call in meta.credits_used. Review authors are only a pseudonymous, stable ID: names, profile photos and profile links are never returned.
{
"data": [
{
"id": "Ci9DQUlRQUNvZENodHljRjlvT2xKVVpXdzNXbGhzTFhWT1VrRjFUVTQ0VUVsdVZXYxAB",
"rating": 5,
"published_at": "2026-11-14T19:42:10Z",
"relative_date": "a week ago",
"language": "it",
"text": "Bistecca perfetta e servizio gentilissimo. Prenotate!",
"translated_text": "Perfect steak and very kind service. Book ahead!",
"author": {
"id": "a_5f2c9e1b7d43"
},
"owner_response": {
"text": "Grazie mille, vi aspettiamo presto!",
"translated_text": "Thank you so much, see you soon!",
"relative_date": "6 days ago"
},
"photos": [],
"details": {
"Price per person": "€30–40",
"Food": "5",
"Service": "5",
"Atmosphere": "4"
},
"source": "Google"
}
],
"pagination": {
"next_cursor": "CAESBkVnSUlDZw",
"has_more": true
},
"meta": {
"credits_used": 1,
"cached": false,
"place_id": "ChIJ8cLgoQNUKhMReGlaTjwrH40",
"cid": "10168894021638449528",
"sort": "newest",
"language": "en",
"original_language": null
}
}Illustrative values for a fictional restaurant: a real response carries the live data of the place you ask for.
Response fields
| Field | Type | Description |
|---|---|---|
| data[].id | string | Stable review ID: use it to skip reviews you already have. |
| data[].rating | integer | null | Stars, from 1 to 5. |
| data[].published_at | string | null | Publication time, ISO 8601 in UTC. |
| data[].relative_date | string | null | The date as Google shows it, e.g. “a week ago”, in the requested language. |
| data[].language | string | null | Original language of the review. |
| data[].text | string | null | Original text; null for a rating without text. |
| data[].translated_text | string | null | Google's translation into the requested language, when it differs from the original. |
| data[].author.id | string | null | Pseudonymous, stable author ID. Names, photos and profile links are never returned. |
| data[].owner_response | object | null | The owner's reply: text, translated_text and relative_date. |
| data[].photos | object[] | Photos attached to the review: url, width and height. |
| data[].details | object | Structured answers, e.g. price per person and the food, service and atmosphere ratings. |
| pagination | object | next_cursor and has_more: repeat the call with the cursor until has_more is false. |
| meta.credits_used | integer | Credits charged for this call: always 1. |
Parameters
| Parameter | In | Type | Default | Description |
|---|---|---|---|---|
| place | path | string | required | Place ID (ChIJ…), CID or feature ID (0x…:0x…). To start from a Google Maps link, convert it with /v1/places/resolve first. |
| sort | query | string | relevant | relevant, newest, highest or lowest. |
| language | query | string | en | Language of the relative dates and target of the translation, e.g. en, it, pt-BR. |
| original_language | query | string | – | Only reviews originally written in this language, e.g. it. Each call reads one page of the review feed, so a filtered page can hold fewer reviews than limit, even none, with a cursor to continue. |
| limit | query | integer | 20 | Reviews per page, from 1 to 20. |
| cursor | query | string | – | pagination.next_cursor of the previous page. Cursors are opaque and belong to one place. |
Without a key the API answers 401 missing_api_key, with a wrong or disabled key 401 invalid_api_key, and with no credits left 402 insufficient_credits. When Google Maps cannot be reached the answer is 503 upstream_unavailable: retry in a minute. Errors are never billed, and every error code is documented.
What you get, and what you don't
The endpoint reads the review feed Google shows to signed-out visitors and pages through it to the end: on a place with thousands of reviews you can keep going, page after page, with the same cursor mechanism. Pages are cached for 24 hours, so asking again for the same page within a day is fast.
Google offers no filter by date or by rating. To collect only new reviews, sort by newest and stop at the first review ID you already have; to read the complaints first, sort by lowest. Reviewer names and avatars are left out by design, which keeps the data you store free of personal details.
Use cases
Reputation monitoring
Poll the newest reviews of your locations every day, alert on one-star reviews and track the average rating over time, across every branch of a chain.
Sentiment analysis and LLMs
Feed hundreds of real reviews to a model to find what customers praise and what they complain about, with the translation already done for you.
Competitor research
Read every review of the competitors in your area to learn which dishes, services or prices people mention, and where they fall short.
Owner replies
See which reviews got an answer from the owner and how quickly, to measure customer care or to draft replies to the ones still waiting.
Reviews and the official Google Places API
The official Google Places API returns at most 5 reviews per place, chosen by Google, with no way to page further. It is the right choice when you need Google's official terms; for analysis you usually need the whole list.
ScrapeMapsAPI returns every review with cursor paging, sorting and a language filter, at 1 credit per page of 20: 1,000 reviews take 50 calls, that is $0.15 at the list price and $0.075 with the largest credit pack.
Pricing
Reviews are billed per call: 1 credit for a page of up to 20 reviews, whatever it holds. 100 reviews take 5 calls (5 credits); a page left empty by a language filter is still a call. The 200 free calls of every month cover up to 4000 reviews.
- 200 free calls every month, no credit card
- Then $3 per 1,000 calls, down to $1.50 with credit packs
- 1 credit per successful call; errors are free
- Credits valid for 12 months from purchase, no subscription
Also in the MCP server for AI assistants
Ask your assistant “what do customers complain about at this restaurant?” and it calls get_reviews, after resolve_place if you gave it a Google Maps link.
The MCP server gives Claude, Cursor and other MCP clients the same data as tools. Run it with uvx scrapemapsapi-mcp (or npx -y scrapemapsapi-mcp) with your API key in SCRAPEMAPSAPI_API_KEY; the MCP server guide has the setup for each client. Tool calls are billed like API calls.
Tools: get_reviews, resolve_place, get_place
Frequently asked questions
- Can I get more than 5 reviews per place?
- Yes. The API returns every review Google shows for the place, page by page: 20 per request, with pagination.next_cursor to fetch the next page until has_more is false.
- How much does it cost to get Google Maps reviews?
- 1 credit per call, and a call returns up to 20 reviews: 100 reviews cost 5 credits. Every account gets 200 free calls a month, then credits cost $3 per 1,000 ($0.15 per 1,000 reviews), down to half with credit packs. Errors are free.
- Do I need a Google API key or a Google account?
- No. You only need a ScrapeMapsAPI API key, sent in the X-API-Key header or as Authorization: Bearer. There is no Google Cloud project to set up.
- Can I get only the reviews in one language, or translated?
- Both. original_language keeps only the reviews written in that language (e.g. it), and language sets the translation target: translated_text holds Google's translation when it differs from the original.
- Which identifier of the place do I need?
- A place ID (ChIJ…), a CID or a feature ID (0x…:0x…). If you only have a Google Maps link, including a maps.app.goo.gl short link, the resolve endpoint converts it for 1 credit.
- Are reviewer names included?
- No. Each author is a pseudonymous, stable ID, so you can count the reviews of one author without storing personal data. Names, profile photos and profile links are never returned.
Related APIs and tools
- Google Maps Places APISearch places by text, optionally around a point, 20 per page with cursor paging.
- Google Maps Place Details APIAddress, coordinates, opening hours, phone, website, attributes and photos of one place.
- Free Google Maps reviews toolPaste a Google Maps link and see the place with its 10 newest reviews, without an account.
Every parameter, field and error code is in the API reference.
Start fetching Google Maps reviews
Create an account and get 200 free calls every month. Your first reviews are one quick start away.