instagram/
comment-replies

投稿URLとコメントIDから公開Instagramコメントへの返信を収集し、返信テキスト、投稿者、いいね数、タイムスタンプ、メンションされたアカウントを返します。

Instagram Comment Replies API

投稿URL + コメントID
返信スレッド
最大1,000件の返信
結果1件あたり0.3クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

Instagram Comment Replies

コメントへの返信は、1件のInstagramコメントの下に広がる会話で、質問に答えたり、主張に反論したり、友人をタグ付けして呼び込んだりする場です。各返信にはテキスト、投稿者、いいね数、投稿時刻が含まれるため、投稿をめぐる空気感を読み取ったり、ブランドが顧客からの質問に公開の場でどう対応しているかを確認したりするのに役立ちます。

Instagram Comment Replies API の主な機能

  • 1件のコメントへの返信を取得投稿、リール、IGTVのリンクと、そのコメントのIDをタスクに指定すると、そのコメントへの返信が1件ずつ別のレコードとして返ります。
  • 返信の詳細情報各返信には、テキスト、投稿日時、いいね数に加え、投稿者のユーザー名、表示名、アバター、認証バッジの有無が含まれます。
  • スレッドにたどれるIDparent_id は返信先のコメント、post_id は投稿のメディアIDを保持するため、コメントや投稿のデータとそのまま結合できます。
  • 長いスレッドも1タスクで取得results_limit は最大1,000件まで指定でき、スレッドのページ送りはタスクが自動で行います。

Instagram Comment Replies API のパラメータ

パラメータ必須説明
url必須対象のコメントがある投稿、リール、IGTV動画へのリンクです。
comment_id必須返信を取得したいコメントのIDです。同じ投稿のInstagram Commentsの結果にある id フィールドの値を指定します。
results_limit任意返す返信の件数で、1〜1000の範囲で指定します。デフォルトは100です。

Instagram Comment Replies API の使い方

まずInstagram CommentsでコメントIDを取得し、そのコメントへの返信をリクエストします。

  1. Instagram Commentsで投稿のコメントを収集し、metrics.replies_count が0より大きいコメントの id を控えます。
  2. 投稿URLとその comment_id を /v1/instagram/comment-replies に POST します。
  3. GET /v1/tasks/{task_id} をポーリングし、status が succeeded になったら results.items に返信が入っています。
  4. 長いスレッドは、results.has_more が true の間、results.next_cursor をたどって取得します。
curl -X POST "https://api.socq.ai/v1/instagram/comment-replies" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.instagram.com/p/DRhvwVLAHAG/","comment_id":"18117277147949901","results_limit":100}'

# comment_id is the id of a comment from Instagram Comments.
# Poll GET /v1/tasks/{task_id} for the replies.

Instagram Comment Replies API の主なユースケース

  • 投稿をめぐる空気感の把握: いいね数の多いコメントへの返信を読み、ディスカッションが好意的か批判的かを確認します。
  • カスタマーケアの確認: ブランドアカウントが、投稿のコメント欄に寄せられた質問にどれだけ迅速かつ適切に答えているかを確認します。
  • タグ付けされたアカウントの追跡: extra.mentions を使い、コメントの下の会話に誰が呼び込まれているかを把握します。

Instagram Comment Replies API 活用のヒント

  • 返信の取得は、Instagram Commentsで metrics.replies_count が0より大きいコメントに絞ってください。
  • その replies_count を results_limit に指定すると、1回のリクエストでスレッド全体を過不足なく取得できます。
  • ほとんどの返信は @メンションで始まるため、テキストの照合ではなく parent_id で親コメントと紐づけてください。

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

  • Instagram Followers Count API — 公開プロフィールのアカウント情報と、表示中のフォロワー数・フォロー数・投稿数を取得します。
  • Instagram Posts API — ユーザー名から、公開投稿、メディア、ハッシュタグ、メンション、タイムスタンプ、エンゲージメントを取得します。
  • Instagram Reels API — ユーザー名から、公開リール、メディア、オーディオ、ハッシュタグ、メンション、エンゲージメントを取得します。
  • Instagram Comments API — 投稿URLから、公開コメント、投稿者、タイムスタンプ、いいね、返信を取得します。
  • Instagram Profiles API — ユーザー名から、公開プロフィールのアカウント情報、プロフィール文、リンク、アカウント属性、カテゴリ、表示中のカウントを取得します。
  • Instagram Post Info API — 既知の公開投稿、リール、旧IGTVのURLを検索し、キャプション、投稿者情報、メディア、タイムスタンプ、表示中のエンゲージメント、入力情報を返します。

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

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

Instagram Comment Replies API — よくある質問

Instagram Comment Replies APIは、投稿URLとコメントIDを入力として、公開Instagramコメント1件への返信を収集するAPIです。各返信のID、テキスト、投稿者、いいね数、投稿日時、親コメントと投稿のIDを返します。

投稿URLとコメントのIDを送信すると、タスクがそのコメントへの返信を results_limit の件数まで返します。

同じ投稿についてInstagram Comments APIが返す各コメントの id フィールドです。

はい。投稿、リール、IGTVのリンクに対応しており、/p/ や /reel/ の前にアカウント名が付いたリンクも使えます。

返された返信1件につき0.3クレジットで、返信のないコメントは課金されません。