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を取得し、そのコメントへの返信をリクエストします。
- Instagram Commentsで投稿のコメントを収集し、metrics.replies_count が0より大きいコメントの id を控えます。
- 投稿URLとその comment_id を /v1/instagram/comment-replies に POST します。
- GET /v1/tasks/{task_id} をポーリングし、status が succeeded になったら results.items に返信が入っています。
- 長いスレッドは、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 で親コメントと紐づけてください。
関連API
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 Search API
- Instagram Followers List API
- Instagram Following List API
- Instagram Hashtag Posts API
- Instagram Tagged Posts API
- Instagram Transcript API
- Instagram Audio Reels API
- Instagram Highlight Items API
- Instagram Reels Search API
- Instagram Story Highlights API
- Instagram Trending Reels API
- Instagram Stories API
- Instagram Similar Accounts API
- Instagram Post Likers API
- Instagram Location Info API
- Instagram Location Posts API
- Instagram Location Search API
- Instagram Hashtag Search API
- Instagram Account Age Checker API