facebook/
comment-replies

固定の投稿URLと親コメントIDから公開Facebookの返信を取得し、テキスト、投稿者情報、エンゲージメント、タイムスタンプ、親コメントのコンテキストを正規化レコードとして返します。

Facebook Comment Replies API

コメントへの返信
固定のコメント入力
公開データ
結果1件あたり0.3クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

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をポーリングして、正規化された返信レコードを結果のカーソルページネーションで読み取ります。

  1. 公開Facebook投稿のURLと、その投稿について返された親コメントIDを選びます。
  2. url、comment_id、results_limit を /v1/facebook/comment-replies に 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/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 は任意項目として扱い、返信テキストは信頼できないユーザー生成コンテンツとして処理してください。

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ページのレビューを、レビュー本文、レビュー投稿者のリンク、評価、いいね、タイムスタンプ、企業情報とともに取得します。

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

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

Facebook Comment Replies API — よくある質問

Facebook Comment Replies APIは、既知のFacebookコメントの下にある公開返信スレッドを、会話のコンテキストを保ったまま展開するためのプログラムインターフェースです。固定の投稿URLと親コメントIDを送信すると、SocQが現在のプロバイダー側の返信トークンを解決します。

公開投稿のURLと、同じ投稿について返された親コメントのIDを使用してください。2つの値は同じFacebook上の会話を指している必要があります。

必要ありません。SocQは送信されたURLとコメントIDから現在のプロバイダー側の返信トークンを解決します。従来のトークン入力はAPIの互換性のために残されていますが、このプレイグラウンドでは使用しません。

レコードには、返信ID、URL、テキスト、投稿者IDと名前、表示中の指標、created_at、collected_at、extra.parent_feedback_id が含まれる場合があります。実行時の返信スキーマにはメディアのフィールドは含まれません。

results_limit は20〜2,000の範囲で指定します。ドキュメントのプレイグラウンドの例では20を送信しています。公開返信スレッドの終端に達した場合は早めに終了することがあり、上限は返信100ページです。

保存された返信レコード1件につき0.3クレジットで、タスクごとの基本料金はかかりません。そのため、結果が空の場合に発生するのは、設定されている0の基本料金のみです。