google-maps/
reviews

既知のGoogle Maps URLから公開口コミを取得し、正規化された本文、投稿者の参照、評価、元リンク、タイムスタンプ、スポットの参照、取得可能なメディアを返します。

Google Maps Reviews API

スポットの口コミ
日数による期間フィルター
正規化された口コミレコード
結果1件あたり0.15クレジット
準備完了
準備完了

パラメータを入力してリクエストを送信してください。タスクのステータスと正規化された結果がここに表示されます。

README

SocQ 編集 · 更新

Google Maps Reviews

Google Mapsの口コミは、スポットに対する公開フィードバックのレコードで、本文、投稿者の参照、評価、元リンクと対象スポットのリンク、公開日時と取得日時、メディアを含む場合があります。出典に紐付いたフィードバックのデータセット作成や、既知のスポット間・取得期間ごとの比較に活用できます。

Google Maps Reviews API の主な機能

  • 既知のURLを一括入力別の識別子APIでスポットを解決する代わりに、対応する google.com または goo.gl のURLを1つ以上、1つの非同期タスクで送信できます。
  • 任意の日数ウィンドウ直近の口コミに絞りたい場合は、正の値の days_limit を1つ指定すると、送信したすべてのURL行に適用されます。
  • 安定した口コミレコード口コミの識別情報、本文、投稿者フィールド、評価、スポットの参照、タイムスタンプ、元URL、取得可能なメディアを review v1.0 スキーマで読み取れます。

Google Maps Reviews API のパラメータ

パラメータ必須説明
urls必須google.com、google.com の任意のサブドメイン、goo.gl、または goo.gl のサブドメイン上にある空でないURLを1つ以上、カンマまたは改行で区切って指定します。口コミの取得には既知のマップのスポットURLを使用してください。
days_limit任意任意。口コミの期間ウィンドウとして、プロバイダーへのすべての入力行に適用される正の整数です。省略すると日数による期間フィルターは送信されません。
results_limit任意任意。タスクで保存する口コミの合計件数の上限で、1〜2,000の整数を指定します。デフォルトは100で、ソース側の状況によって件数が少なくなることがあります。

Google Maps Reviews API の使い方

既知のGoogle Maps URLを送信して非同期タスクを追跡し、保存された口コミレコードをタスク結果のカーソルで読み取ります。

  1. google.com または goo.gl 上の、対応するGoogle MapsスポットURLを1つ以上用意します。
  2. urls と、必要に応じて days_limit と results_limit を /v1/google-maps/reviews に POST します。
  3. status が succeeded または failed になるまで /v1/tasks/{task_id} をポーリングします。
  4. /v1/tasks/{task_id}?limit=50 を読み取り、results.has_more が true の間は results.next_cursor で続きを取得します。
curl -X POST "https://api.socq.ai/v1/google-maps/reviews" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.google.com/maps/place/Coffee%20Project%20New%20York%20%7C%20East%20Village/data=!4m7!3m6!1s0x89c2599b5a24d7fd:0x9e354f6cf514b9fc!8m2!3d40.7270884!4d-73.9893820!16s%2Fg%2F11c3svpqld!19sChIJ_dckWptZwokR_LkU9WxPNZ4?authuser=0&hl=en&rclk=1"],"days_limit":3650,"results_limit":3}'

# Poll GET /v1/tasks/{task_id}, then request
# GET /v1/tasks/{task_id}?limit=50&cursor={results.next_cursor}.

Google Maps Reviews API の主なユースケース

  • 既知スポットのフィードバックデータセット: 指定した公開スポットURLのセットについて、口コミ本文、評価、公開日時、元リンクを整備します。
  • 出典を意識した投稿者リサーチ: 取得可能な投稿者名、ユーザー名、プロフィールリンク、口コミURLを保持し、各レコードを公開時の文脈までさかのぼれるようにします。
  • 直近期間の比較: 同じスポットのセットを、記録した days_limit の値で時期を変えて実行し、全履歴であるとは主張せずに、範囲を区切った取得結果同士を比較します。
  • メディア付き口コミのアーカイブ: 取得可能な口コミのメディアを、本文、評価、スポットの参照、取得時刻とあわせて正規化されたリサーチ用レコードに保持します。

Google Maps Reviews API 活用のヒント

  • 解決可能な google.com または goo.gl のマップURLを送信してください。スポット名、Googleビジネスプロフィールのアカウント、Place IDのみでは urls の項目として受け付けられません。
  • days_limit は、正の整数による期間指定に意味がある場合にのみ使用してください。省略すると、プロバイダーへの入力行にそのフィルターは設定されません。
  • results_limit はURLごとの保証件数ではなく、URLバッチ全体で保存される結果の上限として扱ってください。
  • 送信時の results_limit と、タスク読み取り時の limit は区別してください。後者は1〜500の範囲でページサイズを制御し、不透明なカーソルを使用します。
  • 公開ソースで公開されていない場合、本文、投稿者の属性、評価、対象スポットの参照、タイムスタンプ、メディアが欠けることを想定してください。

Google Maps Reviews API 以外に別の種類の公開Google Mapsデータが必要な場合は、これらのAPIをご利用ください。

  • Google Maps Search API — クエリと場所で公開Google Mapsのスポットを検索し、正規化された名称・ID、住所、連絡先、評価、レビュー数、URL、座標の各フィールドを返します。
  • Google Maps Place Details API

他のプラットフォームを見る

Google Mapsのデータを、対応する他のソーシャルプラットフォームの公開データと組み合わせられます。

Google Maps Reviews API — よくある質問

Google Maps Reviews APIは、既知のGoogle Maps URLから公開口コミのレコードを取得し、安定した口コミスキーマで提供するプログラムインターフェースです。対応する公開取得経路で得られるデータのみを返し、ログインが必要なGoogleビジネスプロフィールの管理操作には対応していません。

ランタイムは、ホストが google.com、google.com のサブドメイン、goo.gl、または goo.gl のサブドメインである空でないURLを受け付けます。有用な口コミ結果を得るには、名称や単独の識別子ではなく、既知のGoogle MapsスポットURLを送信してください。

days_limit は任意で、1以上の整数を指定する必要があります。指定した場合、プロバイダーアダプターが同じ値をすべてのURL入力行にコピーします。省略した場合、days_limit フィールドは送信されません。

results_limit のデフォルトは100で、1〜2,000の整数を指定できます。この上限はプロバイダーへのリクエストに渡され、ランタイムもタスク全体の合計が上限に達した時点で保存を停止します。そのため、URLの数、日数ウィンドウ、公開データセットの状況によって結果が少なくなることがあります。

review v1.0 スキーマには、id、platform、resource、type、url、published_at、collected_at、text、author、rating、subject_id、subject_url、media が含まれる場合があります。author は、識別情報、ユーザー名、名前、プロフィールURL、アバターURL、null になり得るアカウントフラグに展開されます。

タスクの基本料金はありません。リクエスト時に results_limit(省略時は100)から見積もった結果1件につき0.15クレジットを確保し、実際に保存された結果1件につき0.15クレジットで精算して、使用されなかった確保分のクレジットは返金されます。結果が空の場合の精算額は0です。