{ "openapi": "3.0.1", "info": { "title": "Instagram Comments Scraper", "description": "Scrape Instagram post comments with the Instagram Comments Scraper. Extract usernames, comment text, likes, replies, and timestamps. Ideal for engagement analysis, sentiment tracking, and audience insights. Fast, reliable, and scalable for single posts or bulk scraping.", "version": "0.3", "x-build-id": "i0huf3nOEacdAYroZ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapier~instagram-comments-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapier-instagram-comments-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/scrapier~instagram-comments-scraper/runs": { "post": { "operationId": "runs-sync-scrapier-instagram-comments-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/scrapier~instagram-comments-scraper/run-sync": { "post": { "operationId": "run-sync-scrapier-instagram-comments-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "directUrls" ], "properties": { "directUrls": { "title": "🔗 Post URLs", "type": "array", "description": "One or more Instagram post/reel URLs (e.g. https://www.instagram.com/p/SHORTCODE/ or https://www.instagram.com/reel/SHORTCODE/). Bare shortcodes work too.", "items": { "type": "string" } }, "scrapingOptions": { "title": "⚙️ Limits, replies & access", "type": "object", "description": "Comment limits, reply options, sort order, and your Instagram session — in one place.", "properties": { "maxComments": { "title": "💬 Max comments per post", "type": "integer", "description": "Maximum number of top-level comments to collect per URL (hard cap 1000). The actor paginates Instagram's comment API until this many are collected or the post runs out.", "minimum": 1, "maximum": 1000, "default": 10, "prefill": 10 }, "maxReplies": { "title": "↪️ Max replies per comment", "type": "integer", "description": "Maximum number of replies fetched for each top-level comment (hard cap 200). Ignored when “Include replies” is off.", "minimum": 0, "maximum": 200, "default": 2, "prefill": 2 }, "sessionId": { "title": "🔐 Session ID", "type": "string", "description": "Required. Paste your Instagram `sessionid` cookie value. Comment surfaces are login-walled, so without it Instagram refuses every request and the run fails with a clear message.", "editor": "textfield" }, "includeNestedComments": { "title": "🧵 Include replies", "type": "boolean", "description": "Collect replies for each top-level comment. When off, `replies` is an empty list (the real `repliesCount` is still reported).", "default": true, "prefill": true }, "isNewestComments": { "title": "🕒 Newest comments first", "type": "boolean", "description": "On → asks Instagram for `sort_order=recent`: strictly newest-first, unranked. Off → `sort_order=popular`: Instagram's ranked “top comments” order. These return genuinely different comment sets, not a re-sort of the same ones.", "default": false, "prefill": false } } }, "proxyConfiguration": { "title": "🌐 Proxy (optional)", "type": "object", "description": "Optional. If left empty the actor tries a direct connection first and then automatically falls back to Apify Proxy. Instagram blocks most datacenter IPs, so residential proxies give the best results." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } }