Instagram Comments API

Instagram Comments

Features

• Multi-post comment collectionCollect comments from one or more public Instagram post URLs in a single request.
• Normalized comment recordsReturn comment IDs, text, author identity, publishing times, collection times, and source URLs in a consistent structure.
• Visible discussion metricsExpose public like and reply counts in normalized metrics fields for comparing discussion activity.
• Traceable conversation contextPreserve post, parent-comment, and submitted input references for joins, deduplication, and conversation analysis.
• Public data boundaryKeep private, restricted, removed, and login-only comments outside the result scope.

Parameters

How to Use

Submit public Instagram post URLs as an asynchronous task, poll its task ID, then read normalized comment records with cursor pagination.

1. Prepare one or more public Instagram post URLs.
2. POST urls to /v1/instagram/comments.
3. Poll /v1/tasks/{task_id} until the status is succeeded or failed.
4. Read /v1/tasks/{task_id}?limit=50 and follow results.next_cursor when more records exist.

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.

Best Use Cases

• Consumer sentiment monitoring: Analyze public comment text, emojis, and visible engagement signals to track how audiences respond to selected posts.
• Trend and opportunity discovery: Find emerging topics, product feedback, feature requests, recurring questions, and early demand signals in public discussions.
• Campaign response analysis: Compare public reactions across campaign posts, creatives, launches, or announcements using consistent comment records.
• Brand and reputation monitoring: Track praise, complaints, recurring concerns, and changes in audience response around selected public posts.
• Competitive and creator research: Study public discussion on competitor and creator posts to compare topics, questions, and visible engagement.
• Engaged audience discovery: Use public author context, comment likes, and reply counts to identify comments and participants driving discussion.
• Analytics and data pipelines: Load normalized comment records into text-analysis, reporting, dashboard, or warehouse workflows.

Pro Tips

• Submit canonical Instagram Post URLs for the posts you want to analyze.
• Start with a small URL batch to confirm coverage before increasing the number of submitted posts.
• Keep the returned task_id and resume polling the same task after a login or network interruption instead of submitting it again.
• After a task succeeds, follow results.next_cursor until has_more is false rather than assuming the first result page is complete.
• Store the comment id together with post_id, post_url, parent_comment_id, and input_url for reliable joins and deduplication.
• Build downstream schemas around comment id, text, author, created_at, collected_at, and source references, then use media and metrics as enrichment fields.
• Use replies_count to rank active discussions and parent_comment_id to preserve comment relationships.
• Apply bounded exponential backoff to temporary failures and honor retry-after when a 429 response provides it.
• Validate and escape comment text before rendering it or sending it into automated analysis workflows.
• Use the Posts API when you also need the parent post text, media, publishing time, or post-level engagement context.

Related APIs