facebook/
company-reviews

/reviews のURLから公開Facebookページのレビューを取得し、レビュー本文、レビュアーのリンク、評価、いいね数、タイムスタンプ、企業のコンテキストを正規化レコードとして返します。

Facebook Company Reviews API

ページのレビュー
レビュアー情報
企業の評価
結果1件あたり0.5クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

Facebook Company Reviews

Facebook企業レビューは、Facebookページに寄せられた公開のおすすめや評価で、書き込まれたフィードバック、レビュアーの情報、投稿日時、表示中のいいね数、企業単位のレビュー指標を含みます。これらのレコードは、フィードバックのリサーチ、評判のスナップショット、レビュアーのコンテキスト分析、既知のページ間の比較に活用できます。

Facebook Company Reviews API の主な機能

  • ページのレビューURLから収集対応するFacebookページの /reviews URLを1つ以上受け付け、各入力で取得可能な公開レビューを収集します。
  • レビューとレビュアーのレコードレビューID、ソースURL、本文、レビュアー名とプロフィールリンク、表示中のいいね数、評価値、投稿日時を正規化された構造で返します。
  • 企業単位のコンテキスト個々のレビューとあわせて企業名、ページURL、総合評価、レビュー総数を保持し、ソース単位での比較に活用できます。

Facebook Company Reviews API のパラメータ

パラメータ必須説明
urls必須facebook.com、www.facebook.com、m.facebook.com 上のFacebookページのレビューURLで、パスに /reviews を含むものです。カンマまたは改行で区切ります。
results_limit任意入力URLごとに取得するレビューの最大数で、20〜2,000の範囲で指定できます。デフォルトは100で、取得可能な公開結果がこれより少ない場合もあります。

Facebook Company Reviews API の使い方

Facebookページの /reviews URLを非同期タスクとして送信し、タスクIDをポーリングして、正規化されたレビューレコードをカーソルページネーションで読み取ります。

  1. パスに /reviews を含む公開FacebookページのURLを1つ以上用意します。
  2. urls と任意の results_limit を /v1/facebook/company-reviews に POST します。
  3. status が succeeded になるまで /v1/tasks/{task_id} をポーリングします。
  4. /v1/tasks/{task_id}?limit=50 を読み取り、results.has_more が true の間は results.next_cursor を cursor として渡します。
curl -X POST "https://api.socq.ai/v1/facebook/company-reviews" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.facebook.com/PepsiCo/reviews/"],"results_limit":100}'

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

Facebook Company Reviews API の主なユースケース

  • フィードバックデータセットの準備: レビュー本文、評価値、投稿日時、ソースURLを使って、後続のトピック分析や感情分析に向けた公開フィードバックのデータセットを準備します。
  • 評判のスナップショットレポート: 個々のレビュー評価と企業単位の評価・レビュー総数を組み合わせ、選定したページの表示中の状態を記録します。
  • レビュアーのエンゲージメント調査: レビュアー名、プロフィールリンク、表示中のいいね数を使って、誰が公開フィードバックを寄せ、どのレビューが反応を集めたかを調べます。

Facebook Company Reviews API 活用のヒント

  • 企業名や一般的なページURLではなく、解決可能なFacebookページの /reviews URLを使用してください。
  • 必要な件数に応じて入力URLごとに results_limit を設定してください。Facebookで公開されているレビュー履歴が少ない場合は、返される行数も少なくなります。
  • 重複する入力URLは収集前に除去されるため、各ページのURLは1回だけ送信してください。
  • Facebookで値が表示されていない場合に備え、レビュアーのリンク、評価、いいね数、タイムスタンプ、企業単位の集計値は null になり得るものとして扱ってください。
  • 保存されたレコードを読み飛ばさずに大規模な完了タスクを読み取るため、results.has_more が false になるまで results.next_cursor をたどってください。

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

  • Facebook Pages API — 公開Facebookページのプロフィール、連絡先、画像、表示中のユーザー評価を取得します。
  • Facebook Posts API — 対応するFacebook URLから、公開投稿、メディア、リアクション、コメント、シェアを取得します。
  • Facebook Comments API — 投稿URLから、公開コメント、投稿者、エンゲージメント、メディア、元のリンクを取得します。
  • Facebook Video Transcript API — 既知の公開動画投稿またはリールのURLから、取得可能な文字起こしテキストと形式を抽出します。
  • Facebook Comment Replies API — 既知のコメントのフィードバックIDと展開トークンを使って、公開返信をテキスト、投稿者情報、エンゲージメント、親コメントの情報とともに取得します。
  • Facebook Profiles API — 既知のFacebook URLから公開プロフィールまたはページを検索し、アカウント情報、プロフィール文、アバター、表示中のカウント、入力情報を返します。

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

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

Facebook Company Reviews API — よくある質問

Facebook Company Reviews APIは、公開Facebookページの /reviews URLからレビューやおすすめを収集し、一貫したフィードバックのセットとしてまとめるプログラムインターフェースです。評判管理チームはこれをスナップショット、テーマ分析、既知のページ間の比較の基盤として利用できますが、対象は公開レビューページで表示されているコンテンツに限られます。

facebook.com、www.facebook.com、m.facebook.com 上の、パスに /reviews を含むFacebookページのURLを1つ以上送信してください。企業名や無関係なページURLは代わりに使用できません。

レコードには、レビューIDとURL、本文、レビュアー名とプロフィールURL、表示中のいいね数、評価値、created_at、collected_at、企業名とURL、企業の評価、レビュー総数が含まれる場合があります。

results_limit はデフォルトが100で、入力URLごとに20〜2,000の整数を指定できます。これは上限値のため、公開状況やソース側の状況によって取得できるレビューが少なくなることがあります。

返されたタスクIDを status が succeeded になるまでポーリングし、その後タスク結果のエンドポイントから保存されたレビューレコードを読み取ってください。

実際に保存されたレビューレコード1件につき0.5クレジットで、タスクごとの基本料金はかかりません。そのため、結果が空の場合は結果に対する料金は発生しません。