Facebook Comments
Facebookコメントは投稿に対する公開の反応で、テキスト、投稿者情報、投稿日時、表示中のいいね数、返信数、メディア、ソースとの関連を含みます。これらの会話のシグナルは、オーディエンスのフィードバック分析、繰り返し寄せられる質問のリサーチ、コミュニティのモニタリング、コンテンツのレポーティングに活用できます。
Facebook Comments API の主な機能
- 複数投稿のコメント収集1回のリクエストで、1つ以上のFacebook投稿URLから公開コメントを取得します。
- 正規化されたコメントレコードコメントID、テキスト、投稿者情報、タイムスタンプ、表示中のエンゲージメント、メディア、ソースリンクを一貫した構造で返します。
- 追跡可能な会話のコンテキスト投稿、親コメント、送信した入力への参照を保持し、結合、重複排除、監査証跡に活用できます。
- 公開データの範囲非公開、制限付き、削除済み、ログイン必須のコンテンツは結果の対象外です。
Facebook Comments API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
urls | 必須 | 公開Facebook投稿のURLです。カンマまたは改行で区切ります。 |
Facebook Comments API の使い方
公開Facebook投稿のURLを非同期タスクとして送信し、タスクIDをポーリングして、正規化されたコメントレコードをカーソルページネーションで読み取ります。
- 公開Facebook投稿のURLを1つ以上用意します。
- urls を /v1/facebook/comments に POST します。
- status が succeeded になるまで /v1/tasks/{task_id} をポーリングします。
- /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を確認してください。
関連API
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から公開プロフィールまたはページを検索し、アカウント情報、プロフィール文、アバター、表示中のカウント、入力情報を返します。