Read Google Maps reviews
litescrape.google.maps.reviewsReturns reviews for one place identified by place_id or data_id; Google Maps responses include both, plus a ready-made reviews_link
- Price
- $0.00015/successAt provider cost
- Success rate
- 87%Last 30 days · 629,155 calls
- Latency p50
- 5.6 sp95 20 s
- Last verified
- Sep 29, 2026Verified working
GEThttps://toolswitch.dev/v1/tools/litescrape.google.maps.reviews?num=5&place_id=ChIJjQxOkUG3RIYRQvNw_5i6b8sPreview- Uses platform quota
- Synchronous response
- Reads public data
Parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
| Query parameters | ||||
gl | string | Optional | Two-letter country code used to localize results, normalized to lowercase. Defaults to us. | us |
hl | string | Optional | Review language code such as en, en-GB, or de. | en |
num | integer | Optional | Number of reviews to return. An initial unfiltered request returns 8 by default and accepts 1 through 100; requests with topic_id, query or next_page_token return 10 by default and accept 1 through 20. | 5 |
query | string | Optional | Free-text filter that returns reviews mentioning these words. Mutually exclusive with topic_id. | parking |
data_id | string | Optional | Hexadecimal Google Maps feature ID, such as the data_id in a Google Maps response. Exactly one of place_id or data_id is required. | 0x89c258e28c304997:0xfcafe4e7ce35ee8c |
sort_by | string | Optional | Review order: qualityScore (most relevant), newestFirst, ratingHigh or ratingLow. | |
timeout | number | Optional | Optional budget for the entire request in seconds, measured from gateway receipt until the response is ready to send. Includes admission, queueing and settlement. Must be greater than 0 and at most 90. On expiry, the call is not billed and returns 503 request_deadline_exceeded with retryable=true and a request ID. Omit to retain the standard server deadline. | |
place_id | string | Optional | Google Place ID. Exactly one of place_id or data_id is required. | ChIJT2h1HKZZwokR0kgzEtsa03k |
topic_id | string | Optional | Return only reviews about one topic. Use a topics[].id from a previous response. Mutually exclusive with query. | |
next_page_token | string | Optional | Opaque token from a previous response. Send it with the same place, language, country, sort and filters, or follow pagination.next. Tokens expire after 30 minutes. | |
source_metadata | boolean | Optional | Set to true to include each review source's icon and rating scale. | |
- Query parameters
glstringOptionalTwo-letter country code used to localize results, normalized to lowercase. Defaults to us.
Example:
ushlstringOptionalReview language code such as en, en-GB, or de.
Example:
ennumintegerOptionalNumber of reviews to return. An initial unfiltered request returns 8 by default and accepts 1 through 100; requests with topic_id, query or next_page_token return 10 by default and accept 1 through 20.
Example:
5querystringOptionalFree-text filter that returns reviews mentioning these words. Mutually exclusive with topic_id.
Example:
parkingdata_idstringOptionalHexadecimal Google Maps feature ID, such as the data_id in a Google Maps response. Exactly one of place_id or data_id is required.
Example:
0x89c258e28c304997:0xfcafe4e7ce35ee8csort_bystringOptionalReview order: qualityScore (most relevant), newestFirst, ratingHigh or ratingLow.
timeoutnumberOptionalOptional budget for the entire request in seconds, measured from gateway receipt until the response is ready to send. Includes admission, queueing and settlement. Must be greater than 0 and at most 90. On expiry, the call is not billed and returns 503 request_deadline_exceeded with retryable=true and a request ID. Omit to retain the standard server deadline.
place_idstringOptionalGoogle Place ID. Exactly one of place_id or data_id is required.
Example:
ChIJT2h1HKZZwokR0kgzEtsa03ktopic_idstringOptionalReturn only reviews about one topic. Use a topics[].id from a previous response. Mutually exclusive with query.
next_page_tokenstringOptionalOpaque token from a previous response. Send it with the same place, language, country, sort and filters, or follow pagination.next. Tokens expire after 30 minutes.
source_metadatabooleanOptionalSet to true to include each review source's icon and rating scale.
Code samples
Replace $TOOLSWITCH_KEY with the key you created in the console.
curl -X GET 'https://toolswitch.dev/v1/tools/litescrape.google.maps.reviews?num=5&place_id=ChIJjQxOkUG3RIYRQvNw_5i6b8s' \
-H "X-Toolswitch-Key: $TOOLSWITCH_KEY"import os
import requests
response = requests.request(
"GET",
"https://toolswitch.dev/v1/tools/litescrape.google.maps.reviews?num=5&place_id=ChIJjQxOkUG3RIYRQvNw_5i6b8s",
headers={"X-Toolswitch-Key": os.environ["TOOLSWITCH_KEY"]},
)
response.raise_for_status()
print(response.text)const response = await fetch("https://toolswitch.dev/v1/tools/litescrape.google.maps.reviews?num=5&place_id=ChIJjQxOkUG3RIYRQvNw_5i6b8s", {
method: "GET",
headers: {
"X-Toolswitch-Key": process.env.TOOLSWITCH_KEY ?? "",
},
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
console.log(await response.text());This gateway API is in preview; its URL and authentication may change. The example parameters are sample data. Calls are billed at $0.00015/success, including the service fee.