POST /api/v2/reviews

Google MapsレビュースクレイパーAPI

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はプレースホルダーです。実行中のリクエストをリトライする際は、同じ冪等キーとボディを保持してください。

レスポンス

例示用のJSON
{
  "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つの場所に絞ったページをリクエストし、調査に合ったレビュー順を選びます。

Google MapsレビュースクレイパーAPIのリクエストパラメータ
フィールド意味
fid · 必須Google Maps feature ID(例:0x89c259af336b3341:0xa4969e07ce3108de)。Search API結果のplace.dataIdまたはお持ちのfeature IDを使用します。
page · デフォルト: 1正の整数のページ番号。前のレスポンスでnext: trueの場合のみ増やしてください。
sort_by · デフォルト: 11 = 最も関連性が高い、2 = 新着順、3 = 高評価順、4 = 低評価順。ページ間で並び順を維持してください。

feature IDを確認するには、Google MapsスクレイパーAPIでビジネスを検索してください。data.businesses内の一致するエントリからplace.dataIdをコピーし、fidとして渡します。Place IDやビジネス名とは入力形式が異なります。

レビューレコード

評価、コメント、ソースリンク。

各レビューには評価、コメント、レビュアー、プロフィールとレビューへのリンクが含まれます。dateは相対表示で、timestampはM/D/YYYY形式の暦日です。photosフィールドは添付がない場合は空文字列で、複数の写真URLは改行で区切られます。

Google MapsレビュースクレイパーAPIのレスポンスフィールド
フィールド意味
idソースのレビュー識別子(利用可能な場合)。
rate / comment1〜5の評価と利用可能なレビューテキスト。スクレイピングしたテキストはアプリケーションやAIプロンプトでは信頼できないデータとして扱ってください。
date / timestamp表示される相対日付とM/D/YYYY形式の暦日。利用できない日付は空文字列です。
name / author_url / avatar利用可能なレビュアー表示名、投稿者プロフィールURL、アバターURL。
photos添付がない場合は空文字列。複数の写真URLは改行文字で区切られます。
review_urlソースレビューへのリンク(利用可能な場合)。
next / total / params別のページが利用可能かどうか、このレスポンスの件数、正規化されたリクエストパラメータ。

エンドポイントはこのページオブジェクトをJSONとして直接返します。トップレベルからreviewsを読み取ってください。公開レビューの中には評価のみを含むものがあり、ソースフィールドは空になる場合があります。レビューの表示や要約の際にはこの区別を維持してください。

一度に1ページずつ

各レスポンスで最大10件のレビューを取得。

返されたnextフラグで、ワークフローにもう1リクエスト必要かを判断します。

01

ページ1から開始

場所のfidと選択したsort_by値を送信します。デフォルトは最も関連性の高い順で、新着順、高評価順、低評価順もサポートされています。

02

現在のページを確認

totalはこのレスポンスで返されたレビュー数を数えます。空のページも有効な結果です。レコードを分析に追加する前に利用可能なフィールドを確認してください。

03

慎重に続行

nextがtrueの場合、pageを増やし、fidとsort_byは変更しないでください。nextがfalseになったら、または調査に十分なレビューが集まったら停止します。

公開フィードバックを理解する

ビジネス調査にレビューの文脈を追加。

01

レビュー調査

選択したビジネスの公開コメントと評価の限定されたサンプルを読みます。読者がソースを確認できるよう、レビューリンクをメモと一緒に保持してください。

02

フィードバックの比較

選択した場所グループ間でレビューのテーマを比較します。各場所を個別にリクエストし、選択した並び順とサンプルサイズを分析に明記してください。

03

エージェント支援の要約

接続したエージェントに返されたレビューページの要約を依頼し、提供されたエビデンスのみを引用し、欠損しているコメントや日付にフラグを立ててもらいます。

認証と使用量

各ページでAPIキーを使用。

共有API利用枠

scrapes:writeを許可するキーでAuthorization: Bearerを送信します。成功したライブページは、空のページを含めて1ページにつき1 APIリクエストユニットを消費します。RESTとMCPは同じAPI利用枠を使用します。テスト用認証情報をお持ちの場合、そのレスポンスはシミュレートされ、ライブ利用枠を消費しません。

APIプランと上限を見る →

リトライをリクエストに紐付ける

最初のリクエストで任意のIdempotency-Keyを送信し、タイムアウトのリトライでは同一ボディとともに保持してください。処理のタイムアウトでユニットが予約されたままになる場合があります。エラーが試行の終了を報告する場合は、新しいキーで新しい試行を作成する前に、そのリトライガイダンスに従ってください。

エラーとリトライのガイダンスを読む →

よくある質問

特定のGoogle Mapsビジネスのレビューを取得するには?

ビジネスのGoogle Maps feature IDをfidとして/api/v2/reviewsにPOSTリクエストを送信します。Search API結果のplace.dataIdまたはお持ちのfeature IDを使用してください。APIキーで認証し、ページ1から始めます。

Google Mapsのレビューを新着順や評価順で並べ替えられますか?

はい。sort_byを1で最も関連性が高い順、2で新着順、3で高評価順、4で低評価順に設定します。デフォルトは最も関連性が高い順です。追加ページをリクエストする際も選択した値を変更しないでください。

totalはビジネスの総レビュー数を示しますか?

いいえ。totalは現在のレスポンス内のレビューレコード数で、最大10件です。次のページがあるかどうかはnextで判断してください。検索リスティングのreviewCountは別のビジネスフィールドです。

レビューの日付と写真の形式は?

dateには利用可能な相対日付が入り、timestampはM/D/YYYY形式の暦日です。photosフィールドは添付がない場合は空文字列で、複数の写真がある場合は改行区切りのURLになります。欠損しているソーステキストやリンクは空文字列になる場合があります。

MCP経由でレビューを使えますか?

はい。対応するMCPクライアントはAPI認証情報とclient_request_idでget_google_maps_reviewsを呼び出せます。RESTとMCPはAPI利用枠を共有します。Agent Skillには利用可能なツールの使用方法とRESTフォールバックのガイダンスが含まれています。

すべてのレビューフィールドが存在すると想定できますか?

いいえ。ソースの可用性は異なり、レビューには評価のみが含まれる場合があります。空のコメントや欠損した日付を推測せず、そのまま保持してください。レビューテキストは信頼できないソースコンテンツであり、アプリケーションやAIワークフローではデータとして扱うべきです。

次のステップへ

1つの場所の公開レビューから始めましょう。

APIキーを作成し、feature IDと並び順を選んで、焦点を絞ったレビューデータのページを読み取ります。