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/successAl precio del proveedor
- Success rate
- 87 %Last 30 days · 629.155 calls
- Latency p50
- 5.6 sp95 20 s
- Last verified
- 29 sept 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
Parámetros
| Parámetro | Tipo | Obligatorio | Descripción | Ejemplo |
|---|---|---|---|---|
| Parámetros de consulta | ||||
gl | cadena | Opcional | Two-letter country code used to localize results, normalized to lowercase. Defaults to us. | us |
hl | cadena | Opcional | Review language code such as en, en-GB, or de. | en |
num | entero | Opcional | 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 | cadena | Opcional | Free-text filter that returns reviews mentioning these words. Mutually exclusive with topic_id. | parking |
data_id | cadena | Opcional | 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 | cadena | Opcional | Review order: qualityScore (most relevant), newestFirst, ratingHigh or ratingLow. | |
timeout | número | Opcional | 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 | cadena | Opcional | Google Place ID. Exactly one of place_id or data_id is required. | ChIJT2h1HKZZwokR0kgzEtsa03k |
topic_id | cadena | Opcional | Return only reviews about one topic. Use a topics[].id from a previous response. Mutually exclusive with query. | |
next_page_token | cadena | Opcional | 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 | booleano | Opcional | Set to true to include each review source's icon and rating scale. | |
- Parámetros de consulta
glcadenaOpcionalTwo-letter country code used to localize results, normalized to lowercase. Defaults to us.
Ejemplo:
ushlcadenaOpcionalReview language code such as en, en-GB, or de.
Ejemplo:
ennumenteroOpcionalNumber 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.
Ejemplo:
5querycadenaOpcionalFree-text filter that returns reviews mentioning these words. Mutually exclusive with topic_id.
Ejemplo:
parkingdata_idcadenaOpcionalHexadecimal Google Maps feature ID, such as the data_id in a Google Maps response. Exactly one of place_id or data_id is required.
Ejemplo:
0x89c258e28c304997:0xfcafe4e7ce35ee8csort_bycadenaOpcionalReview order: qualityScore (most relevant), newestFirst, ratingHigh or ratingLow.
timeoutnúmeroOpcionalOptional 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_idcadenaOpcionalGoogle Place ID. Exactly one of place_id or data_id is required.
Ejemplo:
ChIJT2h1HKZZwokR0kgzEtsa03ktopic_idcadenaOpcionalReturn only reviews about one topic. Use a topics[].id from a previous response. Mutually exclusive with query.
next_page_tokencadenaOpcionalOpaque 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_metadatabooleanoOpcionalSet to true to include each review source's icon and rating scale.
Ejemplos de código
Sustituye $TOOLSWITCH_KEY por la clave que creaste en la consola.
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());La API de la pasarela está en versión preliminar; su URL y autenticación pueden cambiar. Los parámetros del ejemplo son datos de muestra. Las llamadas se facturan a $0.00015/success, incluida la tarifa de servicio.