{ "openapi": "3.0.1", "info": { "title": "Instagram Comments Scraper", "description": "Instagram Comments Scraper: Extract comments, usernames, comment text, timestamps, replies, likes, and engagement data from Instagram posts and Reels. Analyze audience feedback, user interests, sentiment, and conversations for social media research, content strategy, and competitor analysis.", "version": "0.3", "x-build-id": "zhtJtv3Y0zvWE9oGG" }, "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", "properties": { "directUrls": { "title": "๐Ÿ”— Post URLs", "type": "array", "description": "Add one or more Instagram post/reel URLs (example: https://www.instagram.com/p/SHORTCODE/).", "items": { "type": "string" } }, "scrapingOptions": { "title": "โš™๏ธ Limits, replies & access", "type": "object", "description": "Comment limits, reply options, and optional Instagram session - in one place.", "properties": { "maxComments": { "title": "๐Ÿ’ฌ Max comments per post", "type": "integer", "description": "Maximum number of comments to collect per URL. Instagram's logged-out comments endpoint has a real, observed soft rate limit of roughly 10-12 requests per IP per 2 minutes at up to ~14 comments per request - the 500 ceiling reflects that, not an arbitrary cutoff.", "minimum": 1, "maximum": 500, "default": 10 }, "maxReplies": { "title": "โ†ช๏ธ Max replies per comment", "type": "integer", "description": "Maximum number of replies to fetch for each comment. Kept for input compatibility, but replies are currently unobtainable logged out on Instagram's own frontend (no reply-pagination operation exists client-side; Instagram's \"View all replies\" button itself opens a login prompt) - every run returns repliesCount 0 and replies: [], honestly, rather than a fabricated number.", "minimum": 0, "maximum": 50, "default": 2 }, "sessionId": { "title": "๐Ÿ” Session ID", "type": "string", "description": "Paste your Instagram `sessionid` cookie for more reliable access to comment data.", "editor": "textfield" }, "includeNestedComments": { "title": "๐Ÿงต Include replies", "type": "boolean", "description": "Reserved for a future session-authenticated reply path. Has no effect today - see the note on Max replies per comment.", "default": true }, "isNewestComments": { "title": "๐Ÿ•’ Newest first", "type": "boolean", "description": "Kept for input compatibility only - it has no effect. Instagram's logged-out comment endpoint accepts no sort parameter at all and only ever returns one order (verified: newest-first by post date), so there is nothing for this toggle to switch between.", "default": false } } }, "proxyConfiguration": { "title": "๐ŸŒ Proxy (optional fallback)", "type": "object", "description": "Optional. Requests start direct; if you configure a proxy here it is used from the very first request for every post, and the actor automatically escalates to Apify's datacenter, then residential proxies only if a request gets blocked." } } }, "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 } } } } } } } } } }