facebook/
comments

1つ以上の投稿URLから公開Facebookコメントを取得し、正規化されたテキスト、投稿者情報、タイムスタンプ、表示中のエンゲージメント、メディア、ソースリンクを返します。

Facebook Comments API

コメント
公開データ
投稿URL
結果1件あたり0.3クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

Facebook Comments

Facebookコメントは投稿に対する公開の反応で、テキスト、投稿者情報、投稿日時、表示中のいいね数、返信数、メディア、ソースとの関連を含みます。これらの会話のシグナルは、オーディエンスのフィードバック分析、繰り返し寄せられる質問のリサーチ、コミュニティのモニタリング、コンテンツのレポーティングに活用できます。

Facebook Comments API の主な機能

  • 複数投稿のコメント収集1回のリクエストで、1つ以上のFacebook投稿URLから公開コメントを取得します。
  • 正規化されたコメントレコードコメントID、テキスト、投稿者情報、タイムスタンプ、表示中のエンゲージメント、メディア、ソースリンクを一貫した構造で返します。
  • 追跡可能な会話のコンテキスト投稿、親コメント、送信した入力への参照を保持し、結合、重複排除、監査証跡に活用できます。
  • 公開データの範囲非公開、制限付き、削除済み、ログイン必須のコンテンツは結果の対象外です。

Facebook Comments API のパラメータ

パラメータ必須説明
urls必須公開Facebook投稿のURLです。カンマまたは改行で区切ります。

Facebook Comments API の使い方

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

  1. 公開Facebook投稿のURLを1つ以上用意します。
  2. urls を /v1/facebook/comments に POST します。
  3. status が succeeded になるまで /v1/tasks/{task_id} をポーリングします。
  4. /v1/tasks/{task_id}?limit=50 を読み取り、続きのレコードがある場合は results.next_cursor をたどります。
curl -X POST "https://api.socq.ai/v1/facebook/comments" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.facebook.com/facebook/posts/POST_ID"]}'

# Poll GET /v1/tasks/{task_id}, then read /v1/tasks/{task_id}?limit=50 and use data.results.

Facebook Comments API の主なユースケース

  • 顧客フィードバックと感情分析: 公開コメントのテキストを分析し、意見、製品へのフィードバック、質問、繰り返し現れるテーマを把握します。
  • キャンペーンコンテンツの最適化: キャンペーン投稿ごとのコメントの感情や表示中のエンゲージメントを比較し、メッセージやクリエイティブの判断を改善します。
  • ブランドに関する会話のモニタリング: 選定したブランド投稿の公開コメントを、トピック、時間、投稿者、エンゲージメントのシグナル別に整理します。
  • 競合オーディエンスのリサーチ: 競合の投稿に寄せられた公開の反応を調べ、オーディエンスの関心、質問、エンゲージメントの傾向を比較します。
  • オーディエンスのトピック発見: コメントテキストとタイムスタンプのデータセットを構築し、トピックのクラスタリング、トレンドの発見、言語分析に活用します。
  • 積極的なコメント投稿者の発見: 投稿者情報、いいね数、返信数をもとに、継続的に議論を生み出しているコメント投稿者を特定します。
  • 分析とデータ補完: IDとソースURLを使って、構造化されたコメントレコードをキャンペーン、投稿、分析のデータセットと結び付けます。

Facebook Comments API 活用のヒント

  • 各入力が元の投稿に正しく対応するよう、正規の公開Facebook投稿URLを使用してください。
  • 関連する公開投稿URLを1つのリクエストにまとめ、収集タスクをキャンペーンやトピックごとに整理してください。
  • アプリケーションでポーリングや収集ワークフローの再開ができるよう、送信直後にタスクIDを保存してください。
  • タスクが返すすべての結果ページを読み取るため、results.next_cursor が空になるまでたどってください。
  • すべてのレコードとあわせて、コメントID、投稿ID、親コメントID、入力URL、ソースURLを保存してください。
  • 同じデータセット内で重複するレコードの識別と統合には、コメントIDを使用してください。
  • コメント履歴の整理や増分分析には、created_at と collected_at を使用してください。
  • フィールドのマッピングを検証するときや、結果を新しいデータパイプラインに接続するときは、Raw JSONを確認してください。

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

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

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

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

Facebook Comments API — よくある質問

Facebook Comments APIは、1つ以上のFacebook投稿URLから一般公開されているコメントを取得するAPIです。正規化されたテキスト、投稿者情報、タイムスタンプ、いいね数と返信数、メディア、ソースへの参照を返します。

一般公開されているFacebook投稿のURLを使用してください。収集タスクごとに、urls 配列に1つ以上のURLを追加します。

各レコードには、コメントID、テキスト、投稿者情報、ソースURL、いいね数、返信数、メディア、created_at、collected_at、投稿ID、投稿URL、親コメントID、入力URLが含まれる場合があります。

はい。同じリクエストの urls 配列に複数の公開投稿URLを追加してください。

投稿URLを /v1/facebook/comments に送信し、返されたタスクIDを保存して、タスクが成功するまで /v1/tasks/{task_id} をポーリングします。完了したタスクには構造化されたコメント結果が含まれます。

完了後に /v1/tasks/{task_id}?limit=50 を読み取り、レスポンスにカーソルが含まれなくなるまで results.next_cursor で続きを取得してください。

タスクの送信時と結果の取得時に、Authorization ヘッダーでSocQのAPIキーをBearerトークンとして送信してください。

正規化されたコメント、投稿者、エンゲージメント、タイムスタンプ、ソースのフィールドを、分析テーブル、レポート、アプリケーションにマッピングしてください。結合や重複排除に対応できるよう、コメントと投稿の識別子は保持しておいてください。

返されたコメントレコード1件につき0.3クレジットです。タスクごとの基本料金はかかりません。