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/successプロバイダー原価
- Success rate
- 87%Last 30 days · 629,155 calls
- Latency p50
- 5.6 sp95 20 s
- Last verified
- 2026/09/29Verified working
GEThttps://toolswitch.dev/v1/tools/litescrape.google.maps.reviews?num=5&place_id=ChIJjQxOkUG3RIYRQvNw_5i6b8sPreview- Uses platform quota
- Synchronous response
- Reads public data
パラメータ
| パラメータ | 型 | 必須 | 説明 | 例 |
|---|---|---|---|---|
| クエリパラメータ | ||||
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.
例:
ushl文字列任意Review language code such as en, en-GB, or de.
例:
ennum整数任意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.
例:
5query文字列任意Free-text filter that returns reviews mentioning these words. Mutually exclusive with topic_id.
例:
parkingdata_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:0xfcafe4e7ce35ee8csort_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.
例:
ChIJT2h1HKZZwokR0kgzEtsa03ktopic_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());このゲートウェイ API はプレビュー版です。URL や認証方式は変更される場合があります。 パラメータはサンプルデータです。 呼び出し料金は $0.00015/success です。サービス料を含みます。