{ "openapi": "3.0.1", "info": { "title": "Instagram Comments Scraper By Sentiment Analysis", "description": "Instagram Comments Scraper: Extract Instagram comments and analyze sentiment to identify positive, negative, and neutral feedback. Capture comment text, authors, timestamps, and engagement data for audience insights, brand monitoring, customer research, and social media strategy.", "version": "0.1", "x-build-id": "XkunuSUuXjXf8glkm" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/api-empire~instagram-comments-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-api-empire-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/api-empire~instagram-comments-scraper/runs": { "post": { "operationId": "runs-sync-api-empire-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/api-empire~instagram-comments-scraper/run-sync": { "post": { "operationId": "run-sync-api-empire-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": { "analyzeUrls": { "title": "๐Ÿ”— Post URLs to analyze", "type": "array", "description": "Instagram post/reel URLs (or bare shortcodes) to analyze. Example: https://www.instagram.com/p/SHORTCODE/ or just SHORTCODE. Accepts /p/, /reel/, /reels/ and /tv/.", "items": { "type": "string" } }, "maxComments": { "title": "๐Ÿ’ฌ Max comments per post", "minimum": 1, "maximum": 500, "type": "integer", "description": "How many top comments to analyze per post. Example: 20. Max 500 (honest cap โ€” no silent clamp). Default 20.", "default": 20 }, "includeNestedComments": { "title": "๐Ÿงต Include replies", "type": "boolean", "description": "Also collect replies for each top-level comment (replies are analyzed too). Default true.", "default": true }, "maxReplies": { "title": "โ†ช๏ธ Max replies per comment", "minimum": 0, "maximum": 50, "type": "integer", "description": "Replies to fetch per comment when replies are enabled. Example: 5. Max 50. Default 5.", "default": 5 }, "aiEnhancement": { "title": "๐Ÿค– Enable AI sentiment enrichment", "type": "boolean", "description": "OFF by default. When on AND a key is supplied, each comment also gets model-graded sentiment, emotion and topics. Keyless rule-based analytics always run regardless. On failure AI fields are null.", "default": false }, "aiModel": { "title": "๐Ÿงฌ AI Model / Provider", "enum": [ "claude-haiku-4-5", "claude-sonnet-5", "claude-opus-4-8", "gpt-4o-mini", "gpt-4o", "gpt-4.1-mini", "o3-mini", "gemini-2.0-flash-lite", "gemini-2.0-flash", "gemini-2.5-flash", "grok-3-mini", "deepseek-chat", "sonar", "mistral-small-latest" ], "type": "string", "description": "Provider auto-detected from the name: claude-*=Anthropic, gpt-*/o1/o3=OpenAI, gemini-*=Google, grok-*=xAI, deepseek-*=DeepSeek, sonar*=Perplexity, mistral-*=Mistral. Cheaper mini/flash/haiku/lite models are recommended for classification.", "default": "claude-haiku-4-5" }, "aiApiKey": { "title": "๐Ÿ”‘ AI API key", "type": "string", "description": "Provider API key for AI enrichment. Kept secret. Falls back to the provider env var if empty (ANTHROPIC_API_KEY / OPENAI_API_KEY / GEMINI_API_KEY / XAI_API_KEY / DEEPSEEK_API_KEY / PERPLEXITY_API_KEY / MISTRAL_API_KEY)." }, "deduplicateResults": { "title": "๐Ÿงน Deduplicate comments", "type": "boolean", "description": "Drop duplicate comments (same id or identical normalized text) within the run before analysis. Default true.", "default": true }, "includeRunMetadata": { "title": "๐Ÿ—‚๏ธ Include run metadata", "type": "boolean", "description": "Attach a runMetadata block (source URL, run id, scrapedAt) to every row for auditing/scheduled tracking. A full run-metadata block is also written to the key-value store. Default true.", "default": true }, "sessionId": { "title": "๐Ÿชช Instagram session ID (optional)", "type": "string", "description": "Your Instagram `sessionid` cookie. Instagram login-walls its comment surfaces, so this is needed for reliable comment retrieval โ€” without it, runs are likely to return no comments." }, "proxyConfiguration": { "title": "๐ŸŒ Proxy", "type": "object", "description": "Optional proxy. The actor also self-escalates none โ†’ datacenter โ†’ residential when Instagram restricts a request." } } }, "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 } } } } } } } } } }