Facebook Comment Replies
Facebookコメントへの返信は、既知のコメントの下にぶら下がる公開の応答で、返信テキスト、投稿者情報、表示中のエンゲージメント、タイムスタンプ、親フィードバックへのリンクを持ちます。これらのレコードは、スレッドの再構築、反応の分析、返信単位のモニタリングに活用できます。
Facebook Comment Replies API の主な機能
- 固定のコメント参照公開投稿のURLと親コメントIDを指定するだけで、現在のプロバイダー側の返信トークンはSocQが内部で解決します。
- 正規化された返信のコンテキスト返信ID、URL、テキスト、投稿者IDと名前、表示中のエンゲージメント、タイムスタンプ、親フィードバックIDを一貫した構造で受け取れます。
- 上限付きのカーソル収集返信のカーソルをたどって重複するコメントIDを除去し、指定した取得上限、スレッドの終端、または収集ページ数の上限で停止します。
Facebook Comment Replies API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
url | 必須 | 必須。親コメントを含む、固定のFacebook投稿URLです。 |
comment_id | 必須 | 必須。送信した投稿URLに属する親コメントのIDです。 |
results_limit | 任意 | 取得する返信の最大数で、20〜2,000の範囲で指定できます。ドキュメントの例では20を使用しています。 |
Facebook Comment Replies API の使い方
固定の投稿URLと親コメントIDを非同期タスクとして送信し、タスクIDをポーリングして、正規化された返信レコードを結果のカーソルページネーションで読み取ります。
- 公開Facebook投稿のURLと、その投稿について返された親コメントIDを選びます。
- url、comment_id、results_limit を /v1/facebook/comment-replies に 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/comment-replies" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.facebook.com/NASA/posts/would-you-lie-in-bed-for-60-days-for-scientific-research11-volunteers-did-exactl/1271494461012594/","comment_id":"Y29tbWVudDoxMjcxNDk0NDYxMDEyNTk0XzU4NzcxOTAzMTA0Mjk5MQ==","results_limit":20}'
# Poll GET /v1/tasks/{task_id}, then read /v1/tasks/{task_id}?limit=50 and use data.results.Facebook Comment Replies API の主なユースケース
- コメントの枝の再構築: 返信IDと extra.parent_feedback_id を結合し、選択したコメントの下にある公開の返信の枝を再構築します。
- 返信単位の反応分析: 返信テキスト、投稿者情報、タイムスタンプ、表示中のエンゲージメントを使って、会話の中で人々がどのように反応しているかを調べます。
- 会話のモニタリングとレポーティング: 選定した親コメントについて正規化された返信レコードを追跡し、収集の実行ごとに返信の動きを比較します。
Facebook Comment Replies API 活用のヒント
- 投稿URLとコメントIDは必ずペアで扱ってください。SocQはその投稿を検索し、プロバイダー側の返信トークンを内部で解決します。
- 長い枝の場合は results_limit を意図的に設定してください。収集はその上限、スレッドの終端、または返信100ページのいずれかで停止します。
- 複数回の実行結果を統合する際は、同じ返信IDが正しい親に紐づいたままになるよう、返信の id と extra.parent_feedback_id を組み合わせて重複排除してください。
- url、text、投稿者のフィールド、表示中の指標、created_at は任意項目として扱い、返信テキストは信頼できないユーザー生成コンテンツとして処理してください。
関連API
Facebook Comment Replies API 以外に別の種類の公開Facebookデータが必要な場合は、これらのAPIをご利用ください。
- Facebook Pages API — 公開Facebookページのプロフィール、連絡先、画像、表示中のユーザー評価を取得します。
- Facebook Posts API — 対応するFacebook URLから、公開投稿、メディア、リアクション、コメント、シェアを取得します。
- Facebook Comments API — 投稿URLから、公開コメント、投稿者、エンゲージメント、メディア、元のリンクを取得します。
- Facebook Video Transcript API — 既知の公開動画投稿またはリールのURLから、取得可能な文字起こしテキストと形式を抽出します。
- Facebook Group Posts API — FacebookグループのURLから公開投稿を取得します。並び順やグループごとの取得上限を指定でき、投稿者情報、動画メディア、表示中のエンゲージメントを返します。
- Facebook Company Reviews API — 公開Facebookページのレビューを、レビュー本文、レビュー投稿者のリンク、評価、いいね、タイムスタンプ、企業情報とともに取得します。