Instagram comments API
Pass a public Instagram post or Reel URL and get top-level comments — text, author, likes, reply counts — with cursor pagination in the shared Social Fetch envelope.
GET /v1/instagram/posts/comments1 credit per successful request.
About this endpoint
Brand and moderation pipelines often need what people wrote under a post, not the caption alone. You have a `/p/…` or `/reel/…` link, you want comment text plus who wrote it, and you need to page when the thread is long. Scraping Instagram comment GraphQL yourself means the same signed request churn that breaks post parsers.
`GET /v1/instagram/posts/comments` takes a public post or Reel `url` and an optional opaque `cursor`. On a completed lookup, read `data.lookupStatus`, then `data.comments` and `data.page`. Each comment can include id, text, createdAt, likeCount, replyCount (nullable when Instagram does not report it), and an author object with handle, optional platformUserId, verified flag, and avatarUrl. Paginate with `data.page.nextCursor` while `hasMore` is true.
This route lists top-level comments for one media URL. Post metadata and engagement totals live on `GET /v1/instagram/posts`. Spoken text from a Reel is `GET /v1/instagram/posts/transcript`. Pricing is on the credit badge for this operation; bill from `meta.creditsCharged` on every response.
Instagram comments API FAQ
How do I list Instagram post or Reel comments via API?
Call `GET /v1/instagram/posts/comments` with your Social Fetch API key (`x-api-key`) and a public post or Reel `url` query param. Read `data.lookupStatus`, then `data.comments` and `data.page`. Full parameters and examples are in the API docs.
How much does the Instagram comments endpoint cost?
Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged — that field is the billing source of truth.
How does pagination work on Instagram post comments?
Each response includes `data.page.nextCursor` and `data.page.hasMore`. When `hasMore` is true, pass `nextCursor` as the `cursor` query param on the next request. The cursor is opaque — do not invent or parse it.
What fields are in each Instagram comment?
Items can include id, text, createdAt (ISO-8601), likeCount, replyCount (number or null), and author with handle, optional platformUserId, verified, and avatarUrl when Instagram exposes them.
What URL formats does the Instagram comments API accept?
Public Instagram post and Reel URLs. Pass the link as the `url` query param. Private or deleted media resolve as `not_found` with an empty comments list.
Instagram comments vs post detail vs transcript?
Use this route for top-level comment threads. Use `GET /v1/instagram/posts` for media metadata and engagement fields. Use `GET /v1/instagram/posts/transcript` when you need spoken text from a Reel or video post. They are separate paths on the Instagram hub.
Does a found lookup always return comments?
No. `lookupStatus` of `found` means the post or Reel resolved. `data.comments` can still be an empty array when there are no comments or none were returned for that page. You still pay the credit for a completed lookup.
Other Instagram endpoints
- ProfileGET /v1/instagram/profiles/{handle}
- Basic profileGET /v1/instagram/profiles/{userId}/basic
- Profile postsGET /v1/instagram/profiles/{handle}/posts
- Profile reelsGET /v1/instagram/profiles/{handle}/reels
- Profile highlightsGET /v1/instagram/profiles/{handle}/highlights
- HighlightGET /v1/instagram/highlights/{highlightId}
- Post or reelGET /v1/instagram/posts
- TranscriptGET /v1/instagram/posts/transcript