# Instagram Comment API (https://www.socialcrawl.dev/platforms/instagram/comment)

> Resolves a single Instagram comment to a live comment object (current like count, reply count, author, timestamp) without you paginating the comment section. Pass `comment_url` (an `https://www.instagram.com/p/{shortcode}/c/{commentId}/` permalink: reply permalinks `.../c/{parent}/r/{reply}/` are best-effort) OR `post_url` + `comment_id`. Instead of a comment id you can search the comment section: `author_username` or `text_contains` return up to `max` matches under `data.matches` (a search that matches nothing returns 404 and is fully refunded). The response includes `lookup.post_comment_count` (the post's true total, so you can reason about scan coverage) and a `lookup.position_hint`: pass it back on a later lookup to make the re-check faster (the price is the same). Instagram does not expose pinned status or full reply threads to any provider, so `flags.pinned` stays null and deep reply lookups can return `reply_not_resolvable`. Flat 5 credits (15 with `deep_scan=true`); a not-found returns 404 and is fully refunded.

TL;DR: `GET /v1/instagram/comment` costs 5 credits for a standard lookup, 15 with `deep_scan=true`, which keeps paging the thread when the comment is not in the first pages. Reach for deep_scan only after a standard lookup comes back not-found and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `comment_url` | no | An 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_url` | no | The post URL (a `/p/`, `/reel/`, `/reels/`, or `/tv/` link; an app share link `instagram.com/share/...` works too). Combine with `comment_id`, or with `author_username`/`text_contains` for a search. |
| `comment_id` | no | The target comment's numeric id (`pk`). Requires `post_url`. |
| `author_username` | no | Return up to `max` comments authored by this username (no comment id needed). Mutually exclusive with `text_contains` and any comment id. |
| `text_contains` | no | Return up to `max` comments whose text contains this snippet (case-insensitive). Mutually exclusive with `author_username` and any comment id. |
| `deep_scan` | no | Widen the scan budget for deeply-buried comments (raises the per-chain page ceiling and deadline). Bills 15 credits instead of 5. |
| `position_hint` | no | Opaque 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. |
| `max` | no | For `author_username`/`text_contains` search: max matches to return (1-20, default 5). |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/instagram/comment" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### What does the Instagram Comment API return?

Returns one comment's current text, like count, reply count, author, and timestamp, plus the post's total comment count for context. The response uses the same JSON envelope as every SocialCrawl endpoint, with the data, credits_used and request_id fields.

### When should I use the Instagram Comment endpoint?

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

### How much does the Instagram Comment API cost?

The price depends on the request, from 5 to 15 credits per call. Every new account gets 100 free credits. Credits for failed or empty calls are refunded automatically, and there is no subscription.

### What parameters does the Instagram Comment API need?

No parameter is required, so the bare URL works. It also accepts 8 optional parameters, all listed on this page.

### How do I call the Instagram Comment API?

Send a GET request to https://www.socialcrawl.dev/v1/instagram/comment with your API key in the x-api-key header. An Authorization: Bearer header works too.

See the full Instagram API: https://www.socialcrawl.dev/platforms/instagram

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- What does the SocialCrawl Instagram Comment API return?
- How do I get Instagram Comment data with the SocialCrawl API?