Insight Social
GET /v1/instagram/comment

Instagram Comment API

Returns one comment's current text, like count, reply count, author, and timestamp, plus the post's total comment count for context.

50–150 credits, metered · single call · failed calls free · 10 free calls to start

curl "https://api.insightsocial.app/v1/instagram/comment?comment_url=https%3A%2F%2Fwww.instagram.com%2Fp%2FCnpPou9hWqq%2Fc%2F18007013966365752%2F" \
-H "x-api-key: $INSIGHTSOCIAL_API_KEY"
200 OKJSON
{
"success": true,
"platform": "instagram",
"endpoint": "/v1/instagram/comment",
"schema_version": "2",
"data": {
"comment": {
"id": "<string>",
"url": "<string | null>",
"parent_id": "<string | null>",
"post_id": "<string | null>",
"text": "<string | null>",
"author": {
"id": "<string | null>",
"username": "<string | null>",
"display_name": "<string | null>",
"avatar_url": "<string | null>",
"verified": "<boolean | null>"
},
"engagement": {
"likes": "<integer | null>",
"replies": "<integer | null>"
},
"flags": {
"pinned": "<boolean | null>",
"deleted": "<boolean>"
},
"published_at": "<string | null>",
"language": "<string | null>",
"replies": "<array | null>",
"ext": "<object | null>"
}
},
"unavailable": [],
"credits_used": "<integer>"
}

When to use it

Use it when you already know which comment you want, so you do not have to page through post/comments to find it again.

Parameters

Query parameters for GET /v1/instagram/comment. Send your key in the x-api-key header.

NameRequiredDescription
comment_urlOne of comment_url, post_urlAn Instagram comment permalink: https://www.instagram.com/p/{shortcode}/c/{commentId}/ (or a reply permalink .../c/{parent}/r/{reply}/, best-effort). Mutually exclusive with post_url+comment_id.
post_urlOne of post_url, comment_urlThe post URL (a /p/, /reel/, /reels/, or /tv/ link). Combine with comment_id, or with author_username/text_contains for a search.
comment_idNoThe target comment's numeric id (pk). Requires post_url.
author_usernameNoReturn up to max comments authored by this username (no comment id needed). Mutually exclusive with text_contains and any comment id.
text_containsNoReturn up to max comments whose text contains this snippet (case-insensitive). Mutually exclusive with author_username and any comment id.
deep_scanNoWiden the scan budget for deeply-buried comments (raises the per-chain page ceiling and deadline).
position_hintNoOpaque token from a prior lookup's lookup.position_hint. Passing it back replays just the last-known sort chain first, making a re-check of an already-found comment cheap.
maxNoFor author_username/text_contains search: max matches to return (1-20, default 5).

Response fields

The same unified schema every platform returns, so code written for Instagram works on the other eight. A field the platform did not provide is null and listed in unavailable.

FieldTypeNotes
idstringAn identifier, always a string. Never parse it as a number: several platforms use ids above 2^53.
urlstring | null
parent_idstring | nullAn identifier, always a string. Never parse it as a number: several platforms use ids above 2^53.
post_idstring | nullAn identifier, always a string. Never parse it as a number: several platforms use ids above 2^53.
textstring | null
author.idstring | null
author.usernamestring | null
author.display_namestring | null
author.avatar_urlstring | null
author.verifiedboolean | null
engagement.likesinteger | nullA count. null when the platform does not expose it; 0 only when it is really zero.
engagement.repliesinteger | nullA count. null when the platform does not expose it; 0 only when it is really zero.
flags.pinnedboolean | null
flags.deletedboolean
published_atstring | nullISO-8601 timestamp in UTC, ending in Z.
languagestring | nullThe content's language as the platform states it, e.g. en, pt-BR. Detected languages come later (§7.1).
repliesarray | null
extobject | nullPlatform-specific fields, snake_case.

Every field, error and example is in the Instagram Comment API reference.

How much does the Instagram Comment API cost?

Metered: 50–150 credits a call. The ceiling is reserved when the call starts and you are charged what it actually read.

  • Failed calls are free

    A call that errors or finds nothing costs 0 credits.

  • Know the price first

    Add dry_run=1 and the response quotes the call without making it. Nothing is charged.

  • One balance

    API calls and Chrome extension exports share the same credits, on the free plan too.

Instagram Comment API: frequently asked questions

Send GET /v1/instagram/comment with either comment_url or post_url and your key in the x-api-key header. Returns one comment's current text, like count, reply count, author, and timestamp, plus the post's total comment count for context.