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つ以上の公開Instagram投稿URLを用意します。
- urls を /v1/instagram/comments に POST します。
- status が succeeded または failed になるまで /v1/tasks/{task_id} をポーリングします。
- /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を使用してください。
関連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 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