Instagram Comments API Reference
Comments on a post, with author handle and like count.
Maintained by the InScrape API team · Last reviewed 2026-09-19
GET /v1/instagram/comments1 credit per requestRequest examples
Choose your language
All examples call the same REST endpoint.
curl "https://api.inscrape.dev/v1/instagram/comments?url=https%3A%2F%2Fwww.instagram.com%2Fp%2FC8QltIdyBGH%2F" \
-H "x-api-key: $INSCRAPE_KEY"Response examples
Explore the response
Switch tabs to inspect representative payloads.
Include
{ "success": true, "credits_charged": 1, "credits_remaining": 843, "processing_time_ms": 1842, "requested_at": "2026-09-13T14:32:18Z", "comments_returned": 1, "replies_returned": 0, "total_returned": 1, "reply_initial_requests": 0, "reply_cursor_requests": 0, "reply_total_requests": 0, "reply_total_credits": 0, "query": { "url": "https://www.instagram.com/p/C8QltIdyBGH/" }, "data": { "comments": [ { "comments_index": 1, "pk": "18091234567890123", "text": "Incredible view — thanks for sharing.", "owner": { "pk": "25025320", "username": "instagram", "full_name": "Instagram", "is_private": false, "is_verified": true, "profile_pic_url": "https://cdn.example.com/instagram.jpg" }, "childCount": 1, "reply_total_requests": 0, "reply_credits_charged": 0 } ], "next_cursor": "comments_cursor_example", "has_next_page": true }}Headers
| Name | Type | Required | Description |
|---|---|---|---|
| x-api-key | string | Yes | Your API key. All keys on a team share one credit pool. |
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
| url | string | Yes | Full post URL or bare shortcode |
| cursor | string | No | Valid for up to 3 minutes, or until the pagination session ends. If expired, start a new request. |
| include_media | boolean | No | Return the post or reel mediadefault: false |
| include_replies | boolean | No | Return comment repliesdefault: false |
Errors
| Status | Code | When |
|---|---|---|
400 | INVALID_PARAMS | A required parameter is missing or the wrong type. |
401 | INVALID_API_KEY | The key is unknown or has been revoked. |
402 | INSUFFICIENT_CREDITS | Balance is below this endpoint's cost. |
402 | KEY_LIMIT_REACHED | This API key has reached its credit limit. |
404 | ENDPOINT_NOT_FOUND | The API endpoint does not exist. Check the API URL and endpoint path. No credits are charged. |
410 | CURSOR_EXPIRED | The cursor expired or is invalid. Start again from the first page. |
500 | SCRAPE_FAILED | Upstream fetch failed after retries. |
503 | SERVICE_UNAVAILABLE | The API is temporarily unavailable. Check credits_charged; failures before resource use are free. |
504 | UPSTREAM_TIMEOUT | The upstream scraper timed out. |
Completed lookups return 200 and are charged at the endpoint rate, including private accounts and confirmed missing targets. Empty or missing targets return empty lists; an unavailable Profile is null. Documented empty next-page responses remain free. Check credits_charged on every response.