Read Google Maps reviews

litescrape.google.maps.reviews

Returns reviews for one place identified by place_id or data_id; Google Maps responses include both, plus a ready-made reviews_link

价格: $0.00015/success按供应商原价
成功率: 87%近 30 天 · 629,155 次
延迟 p50: 5.6 秒p95 20 秒
最后验证: 2026年9月29日实测可用

GEThttps://toolswitch.dev/v1/tools/litescrape.google.maps.reviews?num=5&place_id=ChIJjQxOkUG3RIYRQvNw_5i6b8s预览

在线试用即将上线供应商文档 ↗

可用平台额度调用
同步返回
读取公开数据

参数

参数	类型	必填	说明	示例
查询参数
`gl`	字符串	可选	Two-letter country code used to localize results, normalized to lowercase. Defaults to us.	`us`
`hl`	字符串	可选	Review language code such as en, en-GB, or de.	`en`
`num`	整数	可选	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`	字符串	可选	Free-text filter that returns reviews mentioning these words. Mutually exclusive with topic_id.	`parking`
`data_id`	字符串	可选	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`	字符串	可选	Review order: qualityScore (most relevant), newestFirst, ratingHigh or ratingLow.
`timeout`	数字	可选	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`	字符串	可选	Google Place ID. Exactly one of place_id or data_id is required.	`ChIJT2h1HKZZwokR0kgzEtsa03k`
`topic_id`	字符串	可选	Return only reviews about one topic. Use a topics[].id from a previous response. Mutually exclusive with query.
`next_page_token`	字符串	可选	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`	布尔	可选	Set to true to include each review source's icon and rating scale.

查询参数
gl字符串可选
Two-letter country code used to localize results, normalized to lowercase. Defaults to us.
示例：us
hl字符串可选
Review language code such as en, en-GB, or de.
示例：en
num整数可选
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字符串可选
Free-text filter that returns reviews mentioning these words. Mutually exclusive with topic_id.
示例：parking
data_id字符串可选
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字符串可选
Review order: qualityScore (most relevant), newestFirst, ratingHigh or ratingLow.
timeout数字可选
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字符串可选
Google Place ID. Exactly one of place_id or data_id is required.
示例：ChIJT2h1HKZZwokR0kgzEtsa03k
topic_id字符串可选
Return only reviews about one topic. Use a topics[].id from a previous response. Mutually exclusive with query.
next_page_token字符串可选
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布尔可选
Set to true to include each review source's icon and rating scale.

代码示例

将 $TOOLSWITCH_KEY 替换为你在控制台创建的密钥。

预览

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());

网关接口为预览版，地址与鉴权方式可能调整。示例参数仅为样例数据。调用按 $0.00015/success 计费，已含服务费。