Social Fetch
Get API key
Instagram hub

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/comments

1 credit per successful request.

Try in playgroundFull API docs

About this endpoint

`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`. Bill from `meta.creditsCharged`.

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`. See the API docs for parameters and examples.

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.

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