{ "openapi": "3.0.1", "info": { "title": "Instagram Comments Scraper", "description": "Scrape public Instagram comments and replies from Posts and Reels. Extract comment text, timestamps, likes, usernames, user IDs, profile pictures, mentions and thread relationships. Process multiple URLs and export clean JSON, CSV or Excel.", "version": "1.0", "x-build-id": "LjskoP4tz9kjxdvnX" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/coregent~instagram-comments-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-coregent-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/coregent~instagram-comments-scraper/runs": { "post": { "operationId": "runs-sync-coregent-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/coregent~instagram-comments-scraper/run-sync": { "post": { "operationId": "run-sync-coregent-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": [ "startUrls" ], "properties": { "startUrls": { "title": "Instagram Post or Reel URLs", "type": "array", "description": "Public Post, Reel or legacy TV URLs: instagram.com/p/{shortcode}/, /reel/{shortcode}/, /reels/{shortcode}/ or /tv/{shortcode}/. Tracking parameters are stripped and duplicates removed. Profile, hashtag, search and story URLs are rejected as free INVALID_URL rows. Up to 1,000 URLs per run.", "default": [ { "url": "https://www.instagram.com/reel/DeR1rDbOo2m/" } ], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "resultsLimit": { "title": "Max comments per URL", "minimum": 1, "type": "integer", "description": "Maximum comment and reply rows saved per input URL. Replies count toward the limit. Typical values: 100, 500, 1,000, 5,000, 10,000.", "default": 100 }, "includeReplies": { "title": "Include replies", "type": "boolean", "description": "Also collect replies. Each reply is its own row with rootCommentId and parentCommentId pointing at the comment it belongs to.", "default": true }, "sort": { "title": "Sort order", "enum": [ "RECENT", "TOP" ], "type": "string", "description": "Instagram's own comment ordering. RECENT = newest first (enables early stopping with a date filter). TOP = Instagram's most relevant comments first. TOP is never simulated by sorting locally.", "default": "RECENT" }, "commentsNewerThan": { "title": "Only comments newer than", "type": "string", "description": "Keep only comments posted after this point. Relative (\"24 hours\", \"7 days\", \"2 weeks\", \"3 months\") or a date (\"2026-09-01\", \"2026-09-01T00:00:00Z\"). Leave empty for no limit. With RECENT sort, pagination stops once older comments are reached. Filtered-out comments are not charged.", "default": "" }, "commentsOlderThan": { "title": "Only comments older than", "type": "string", "description": "Keep only comments posted before this point. Same formats as above. Leave empty for no limit. Newer comments are still paged through (but not charged) to reach older ones.", "default": "" }, "includePostDetails": { "title": "Include post details", "type": "boolean", "description": "Add lightweight Post/Reel context to every row: post ID, shortcode, URL, type (POST / REEL / VIDEO / CAROUSEL), owner username and a caption preview. postId and postUrl are always included.", "default": true }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy configuration. Defaults to Apify Proxy (datacenter), which rotates IPs between sessions to spread Instagram's per-IP limits. Apify Residential is not supported; use Custom proxy URLs for your own residential provider.", "default": { "useApifyProxy": true } }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "Number of Posts/Reels processed in parallel. Comment pages of one post are always fetched in order.", "default": 5 }, "maxRetries": { "title": "Max retries per request", "minimum": 0, "maximum": 8, "type": "integer", "description": "How many times a request is retried on a fresh session/IP after rate limits, login walls or temporary Instagram errors. When Instagram keeps refusing, the post is fetched from an alternative source instead. Deleted, private and comments-disabled content is never retried.", "default": 3 }, "debugMode": { "title": "Debug mode", "type": "boolean", "description": "Enable verbose logging.", "default": false } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }