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をポーリングして、正規化されたレビューレコードをカーソルページネーションで読み取ります。
- パスに /reviews を含む公開FacebookページのURLを1つ以上用意します。
- urls と任意の results_limit を /v1/facebook/company-reviews に POST します。
- status が succeeded になるまで /v1/tasks/{task_id} をポーリングします。
- /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 をたどってください。
関連API
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から公開プロフィールまたはページを検索し、アカウント情報、プロフィール文、アバター、表示中のカウント、入力情報を返します。