Instagram Comments API

Instagram comments by post ID API

Retrieve public Instagram comments using a numeric media ID. Use the method for conversation monitoring, moderation, audience research, and content reporting.

Provide the post's media_id and, when needed, the cursor for the next page. Use the normalized V2 response for new integrations.

Method GET
Entity Comments
Versions 2
What this endpoint does

What you can build with this API method

Review the result and common workflows first, then move to parameters and a working request example.

What this endpoint helps with

The response includes comments, author data, publication timestamps, engagement signals, and a cursor for sequential pagination.

When to use it

Provide the post's media_id and, when needed, the cursor for the next page. Use the normalized V2 response for new integrations.

Common use cases

Conversation monitoring

Collect audience reactions under specific posts for brand monitoring and research.

Comment moderation

Send comments into internal review, labeling, and communication-quality workflows.

Content reporting

Enrich post analytics with comment text, authors, and engagement signals.

Available versions

Response version

Both versions solve the same job and accept the same parameters. Use the switch to compare the response structure and choose the version your client expects.

Response version V2

Switch versions on this page to compare response structures while keeping the same documentation URL.

What stays the same

Authentication, required parameters, and the request shape stay the same across V1 and V2. In practice, you choose the version when you build the endpoint path and when you parse the response.

What changes between versions

The main difference is the response envelope. Use V2 for new integrations and keep V1 only when you need compatibility with an existing client contract.

How to use it

How to call the method

Use the same API key header and the same query parameters for both versions. This documentation shows the shared parameter set first, then version-specific endpoint paths and code snippets.

Input parameters

Shared parameters
Parameter Required Type Example Description
media_id Yes str 25025320 Numeric ID of the Instagram post whose data you want to retrieve.
cursor No str | None QVFB... Next-page cursor returned by the previous response. Omit it for the first page.

Version-specific request path

V2

Choose a version when you copy the exact endpoint path, example URL, and code snippet. The parameter list above stays the same.

GET /api/v2/instagram.com/comments/by-media-id

Normalized format

Code examples

curl --request GET \
  --url "https://www.scrapestorm.net/api/v2/instagram.com/comments/by-media-id" \
  --header "X-API-Key: 00000000-0000-4000-8000-000000000000" \
  --get --data-urlencode 'media_id=25025320' \
  # Optional parameters:
  # --data-urlencode 'cursor=QVFB...'
Response example

Live response by version

The preview keeps key fields and the first collection items so you can scan the response shape quickly. Switching versions changes the JSON format.

Response example

V2 response JSON

Placeholder

A live verification example is not available for V2 yet. This placeholder keeps the standard response envelope visible until a verified example is ready.

{
  "success": true,
  "status": "ok",
  "data": {}
}
What to do next

Continue the evaluation

Use this documentation as the first decision point, then move into pricing, platform coverage, and integration rules before you connect the endpoint for recurring use.

Open the Instagram platform page

Compare adjacent entities, API method groups, and related docs before implementation.

Open platform page

Compare API method pricing

Check where this API method sits inside the public price table before you scale usage.

View pricing

Review integration rules

Use the starter docs to confirm authentication, versioning, retries, and mock vs live behavior.

Open docs
FAQ

Questions teams ask before implementation

Use these answers to decide whether this API method fits your workflow, versioning choice, and rollout plan.

Where can I find an Instagram post's media ID?

Retrieve the media ID from profile, feed, search, or post-details methods. This operation needs the numeric ID rather than the shortcode from the public URL.

How do I retrieve every comment when the result is paginated?

Run the first request without cursor, then pass the cursor from each response into the next request until no next-page cursor is returned.

Which version should a new integration use?

Use V2 for normalized fields and a stable product model. V1 remains available for clients that parse Instagram's platform-native response shape.

Are credits charged for unsuccessful responses?

No. Credits are charged for successful API responses. Check the pricing catalog for the current cost of this and other methods.