instagram/
comments

1つ以上の投稿URLから公開Instagramコメントを収集し、正規化されたテキスト、投稿者情報、タイムスタンプ、投稿の参照情報、表示中のいいね数・返信数を返します。

Instagram Comments API

コメント
公開データ
投稿URL
結果1件あたり0.3クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

Instagram Comments

Instagramコメントは、投稿やリールに寄せられる公開の反応で、テキスト、投稿者情報、タイムスタンプ、表示中のいいね数、返信数、メディア、ソースリンクを含みます。これらの会話シグナルは、フィードバック分析、モデレーションの確認、コミュニティ調査、キャンペーンのレポーティングに活用できます。

Instagram Comments API の主な機能

  • 複数投稿のコメント収集1回のリクエストで、1つ以上の公開Instagram投稿URLからコメントを収集します。
  • 正規化されたコメントレコードコメントID、テキスト、投稿者情報、投稿日時、収集日時、ソースURLを一貫した構造で返します。
  • 表示中のディスカッション指標公開されているいいね数と返信数を正規化された metrics フィールドで提供し、ディスカッションの活発さを比較できます。
  • 追跡可能な会話コンテキスト投稿、親コメント、送信した入力の参照情報を保持し、結合、重複排除、会話分析に利用できます。
  • 公開データの範囲非公開、制限付き、削除済み、ログインが必要なコメントは結果の対象外です。

Instagram Comments API のパラメータ

パラメータ必須説明
urls必須公開Instagram投稿のURLです。カンマまたは改行で区切って指定します。

Instagram Comments API の使い方

公開Instagram投稿URLを非同期タスクとして送信し、タスクIDをポーリングして、正規化されたコメントレコードをカーソルページネーションで読み取ります。

  1. 1つ以上の公開Instagram投稿URLを用意します。
  2. urls を /v1/instagram/comments に POST します。
  3. status が succeeded または failed になるまで /v1/tasks/{task_id} をポーリングします。
  4. /v1/tasks/{task_id}?limit=50 を読み取り、さらにレコードがある場合は results.next_cursor をたどって続きを取得します。
curl -X POST "https://api.socq.ai/v1/instagram/comments" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.instagram.com/p/POST_CODE/"]}'

# Poll GET /v1/tasks/{task_id}, then read /v1/tasks/{task_id}?limit=50 and use data.results.

Instagram Comments API の主なユースケース

  • 消費者センチメントのモニタリング: 公開コメントのテキスト、絵文字、表示中のエンゲージメントシグナルを分析し、選んだ投稿にオーディエンスがどう反応しているかを追跡します。
  • トレンドとビジネス機会の発見: 公開ディスカッションから、新たな話題、商品へのフィードバック、機能要望、よくある質問、需要の兆しを見つけます。
  • キャンペーンへの反応分析: 一貫したコメントレコードを使い、キャンペーン投稿、クリエイティブ、新商品の発表、告知などに対する公開の反応を比較します。
  • ブランド・評判のモニタリング: 選んだ公開投稿について、好意的な声、苦情、繰り返し寄せられる懸念、オーディエンスの反応の変化を追跡します。
  • 競合・クリエイターの調査: 競合やクリエイターの投稿に寄せられた公開ディスカッションを調べ、話題、質問、表示中のエンゲージメントを比較します。
  • 関心の高いオーディエンスの発見: 公開されている投稿者情報、コメントのいいね数、返信数をもとに、ディスカッションを牽引するコメントや参加者を特定します。
  • 分析・データパイプライン: 正規化されたコメントレコードを、テキスト分析、レポーティング、ダッシュボード、データウェアハウスのワークフローに取り込みます。

Instagram Comments API 活用のヒント

  • 分析したい投稿の正規のInstagram投稿URLを送信してください。
  • まずは少数のURLで取得範囲を確認してから、送信する投稿数を増やしてください。
  • ログインやネットワークの中断が起きた場合は、再送信せずに返された task_id を保持して同じタスクのポーリングを再開してください。
  • タスクが成功したら、最初の結果ページで完結していると決めつけず、has_more が false になるまで results.next_cursor をたどってください。
  • 確実な結合と重複排除のために、コメントの id を post_id、post_url、parent_comment_id、input_url とあわせて保存してください。
  • 下流のスキーマはコメントの id、text、author、created_at、collected_at、ソース参照を軸に設計し、media と metrics は補完用フィールドとして使ってください。
  • 活発なディスカッションの順位付けには replies_count を、コメント同士の関係の保持には parent_comment_id を使ってください。
  • 一時的な失敗には上限付きの指数バックオフを適用し、429 レスポンスに retry-after が含まれる場合はそれに従ってください。
  • コメントテキストは、表示や自動分析ワークフローへの送信の前に検証とエスケープを行ってください。
  • 親投稿のテキスト、メディア、投稿日時、投稿単位のエンゲージメントも必要な場合は、Posts APIを使用してください。

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

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

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

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

Instagram Comments API — よくある質問

Instagram Comments APIは、1つ以上のInstagram投稿URLから公開されているコメントを収集するAPIです。正規化されたテキスト、投稿者情報、タイムスタンプ、投稿の参照情報、メディア、表示中のいいね数・返信数を返します。

urls 配列に、正規のInstagram投稿URLを1つ以上指定してください。URLは1行に1つずつ入力するか、カンマで区切って指定します。

正規化された各レコードには、id、text、author、url、metrics、media、created_at、collected_at と、post_id、post_url、parent_comment_id、input_url などのソース参照が含まれます。

はい。同じリクエストの urls 配列に、複数の公開投稿URLを指定してください。

ディスカッションの活発さの比較には replies_count を、コメントと親コメントのつながりの把握には parent_comment_id を使用してください。

コメントテキスト、投稿者情報、タイムスタンプ、いいね数、返信数、投稿の参照情報を、センチメントのモニタリング、トレンドの発見、キャンペーン分析、オーディエンス調査、レポーティングに活用できます。

アカウントの連携は不要です。APIキーでリクエストを認証し、収集したいInstagram投稿URLを送信してください。

タスクエンドポイントから正規化されたJSON結果を読み取り、分析ツール、ダッシュボード、データベース、テキスト処理ジョブ、レポーティングパイプラインに送信してください。

タスクが成功したら /v1/tasks/{task_id}?limit=50 を読み取り、has_more が false になるまで results.next_cursor で続きを取得してください。

返されたコメント結果1件につき0.3クレジットで、結果が空の場合は課金されません。最終的な請求額は、実際の結果件数に基づいてタスク詳細に表示されます。