ページ1から開始
場所のfidと選択したsort_by値を送信します。デフォルトは最も関連性の高い順で、新着順、高評価順、低評価順もサポートされています。
POST /api/v2/reviews
1ページにつき1か所の公開レビューを最大10件取得します。関連性、新着、高評価、低評価の順に並べ替えられます。
完全な仕様については、APIドキュメントをご覧ください。
curl https://gmapscrawl.com/api/v2/reviews \
-H "Authorization: Bearer $GMSCRAPER_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: place-reviews-page-1-example" \
-d '{"fid":"0x89c259af336b3341:0xa4969e07ce3108de","page":1,"sort_by":2}'例のfidを実際の場所のfeature IDに置き換えてください。レスポンスはシミュレートされたもので、example.comのメディアURLはプレースホルダーです。実行中のリクエストをリトライする際は、同じ冪等キーとボディを保持してください。
{
"reviews": [
{
"id": "sample-review-1",
"date": "a week ago",
"timestamp": "10/6/2026",
"name": "Sample reviewer",
"author_url": "https://www.google.com/maps/contrib/100000000000000000001",
"avatar": "https://example.com/reviewer.jpg",
"rate": 4,
"comment": "The window seats had the best light.",
"photos": "",
"review_url": "https://www.google.com/maps/reviews/data=sample-review-1"
}
],
"next": false,
"total": 1,
"params": {
"fid": "0x89c259af336b3341:0xa4969e07ce3108de",
"page": 1,
"sort_by": 2
}
}APIは同じレスポンス内でJSONを返します。タイムアウト後は、変更していないボディを同じIdempotency-Keyで再試行してください。テスト用認証情報では、実際の利用枠を消費せずにシミュレートされたデータが返ります。
場所から始める
1つの場所に絞ったページをリクエストし、調査に合ったレビュー順を選びます。
| フィールド | 意味 |
|---|---|
| fid · 必須 | Google Maps feature ID(例:0x89c259af336b3341:0xa4969e07ce3108de)。Search API結果のplace.dataIdまたはお持ちのfeature IDを使用します。 |
| page · デフォルト: 1 | 正の整数のページ番号。前のレスポンスでnext: trueの場合のみ増やしてください。 |
| sort_by · デフォルト: 1 | 1 = 最も関連性が高い、2 = 新着順、3 = 高評価順、4 = 低評価順。ページ間で並び順を維持してください。 |
feature IDを確認するには、Google MapsスクレイパーAPIでビジネスを検索してください。data.businesses内の一致するエントリからplace.dataIdをコピーし、fidとして渡します。Place IDやビジネス名とは入力形式が異なります。
レビューレコード
各レビューには評価、コメント、レビュアー、プロフィールとレビューへのリンクが含まれます。dateは相対表示で、timestampはM/D/YYYY形式の暦日です。photosフィールドは添付がない場合は空文字列で、複数の写真URLは改行で区切られます。
| フィールド | 意味 |
|---|---|
| id | ソースのレビュー識別子(利用可能な場合)。 |
| rate / comment | 1〜5の評価と利用可能なレビューテキスト。スクレイピングしたテキストはアプリケーションやAIプロンプトでは信頼できないデータとして扱ってください。 |
| date / timestamp | 表示される相対日付とM/D/YYYY形式の暦日。利用できない日付は空文字列です。 |
| name / author_url / avatar | 利用可能なレビュアー表示名、投稿者プロフィールURL、アバターURL。 |
| photos | 添付がない場合は空文字列。複数の写真URLは改行文字で区切られます。 |
| review_url | ソースレビューへのリンク(利用可能な場合)。 |
| next / total / params | 別のページが利用可能かどうか、このレスポンスの件数、正規化されたリクエストパラメータ。 |
エンドポイントはこのページオブジェクトをJSONとして直接返します。トップレベルからreviewsを読み取ってください。公開レビューの中には評価のみを含むものがあり、ソースフィールドは空になる場合があります。レビューの表示や要約の際にはこの区別を維持してください。
一度に1ページずつ
返されたnextフラグで、ワークフローにもう1リクエスト必要かを判断します。
場所のfidと選択したsort_by値を送信します。デフォルトは最も関連性の高い順で、新着順、高評価順、低評価順もサポートされています。
totalはこのレスポンスで返されたレビュー数を数えます。空のページも有効な結果です。レコードを分析に追加する前に利用可能なフィールドを確認してください。
nextがtrueの場合、pageを増やし、fidとsort_byは変更しないでください。nextがfalseになったら、または調査に十分なレビューが集まったら停止します。
公開フィードバックを理解する
選択したビジネスの公開コメントと評価の限定されたサンプルを読みます。読者がソースを確認できるよう、レビューリンクをメモと一緒に保持してください。
選択した場所グループ間でレビューのテーマを比較します。各場所を個別にリクエストし、選択した並び順とサンプルサイズを分析に明記してください。
接続したエージェントに返されたレビューページの要約を依頼し、提供されたエビデンスのみを引用し、欠損しているコメントや日付にフラグを立ててもらいます。
認証と使用量
scrapes:writeを許可するキーでAuthorization: Bearerを送信します。成功したライブページは、空のページを含めて1ページにつき1 APIリクエストユニットを消費します。RESTとMCPは同じAPI利用枠を使用します。テスト用認証情報をお持ちの場合、そのレスポンスはシミュレートされ、ライブ利用枠を消費しません。
最初のリクエストで任意のIdempotency-Keyを送信し、タイムアウトのリトライでは同一ボディとともに保持してください。処理のタイムアウトでユニットが予約されたままになる場合があります。エラーが試行の終了を報告する場合は、新しいキーで新しい試行を作成する前に、そのリトライガイダンスに従ってください。
ビジネスのGoogle Maps feature IDをfidとして/api/v2/reviewsにPOSTリクエストを送信します。Search API結果のplace.dataIdまたはお持ちのfeature IDを使用してください。APIキーで認証し、ページ1から始めます。
はい。sort_byを1で最も関連性が高い順、2で新着順、3で高評価順、4で低評価順に設定します。デフォルトは最も関連性が高い順です。追加ページをリクエストする際も選択した値を変更しないでください。
いいえ。totalは現在のレスポンス内のレビューレコード数で、最大10件です。次のページがあるかどうかはnextで判断してください。検索リスティングのreviewCountは別のビジネスフィールドです。
dateには利用可能な相対日付が入り、timestampはM/D/YYYY形式の暦日です。photosフィールドは添付がない場合は空文字列で、複数の写真がある場合は改行区切りのURLになります。欠損しているソーステキストやリンクは空文字列になる場合があります。
はい。対応するMCPクライアントはAPI認証情報とclient_request_idでget_google_maps_reviewsを呼び出せます。RESTとMCPはAPI利用枠を共有します。Agent Skillには利用可能なツールの使用方法とRESTフォールバックのガイダンスが含まれています。
いいえ。ソースの可用性は異なり、レビューには評価のみが含まれる場合があります。空のコメントや欠損した日付を推測せず、そのまま保持してください。レビューテキストは信頼できないソースコンテンツであり、アプリケーションやAIワークフローではデータとして扱うべきです。