{ "openapi": "3.0.1", "info": { "title": "Instagram Reels & Comments Scraper | Brand Monitor", "description": "Collect public Instagram reel metrics and sample comments for brand reports. Compare observed plays and likes across runs, with source IDs and clear coverage limits.", "version": "0.1", "x-build-id": "ngpyFg4i6chs3xicK" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/ntriqpro~instagram-reels-comments-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-ntriqpro-instagram-reels-comments-monitor", "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/ntriqpro~instagram-reels-comments-monitor/runs": { "post": { "operationId": "runs-sync-ntriqpro-instagram-reels-comments-monitor", "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/ntriqpro~instagram-reels-comments-monitor/run-sync": { "post": { "operationId": "run-sync-ntriqpro-instagram-reels-comments-monitor", "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": [ "usernames" ], "properties": { "usernames": { "title": "Instagram usernames (limited for free users)", "minItems": 1, "maxItems": 20, "type": "array", "description": "Public Instagram usernames only, without @, URLs, passwords or cookies. Duplicate handles are processed once. FREE: first 1 profile; paid: at most 20 profiles.", "items": { "type": "string" } }, "maxReelsPerProfile": { "title": "Maximum reels per profile (limited for free users)", "minimum": 1, "maximum": 100, "type": "integer", "description": "Upper limit per brand, not a coverage guarantee. FREE is capped at 2; paid allows up to 100. Ordering is limited to timestamps available from public responses and cannot guarantee the account's newest reels." }, "maxCommentsPerReel": { "title": "Maximum sample comments per reel (limited for free users)", "minimum": 0, "maximum": 50, "type": "integer", "description": "Upper limit on available top-level sample comments. FREE is capped at 5; paid allows up to 50. The public endpoint often supplies about 15 regardless of this setting. Replies and full/newest comment coverage are not promised." }, "includeAnalysis": { "title": "Include observed brand summary", "type": "boolean", "description": "Create an optional $0.005 summary per brand with observations: question examples and hashtags from the collected sample. This is not a representative sentiment survey. FREE: at most 1 summary." }, "monitorKey": { "title": "Monitor key (paying users only)", "maxLength": 80, "type": "string", "description": "Optional stable label for repeated runs in your Apify account. Paid plans only: use the same key and targets to retain comparison baselines in this Actor's named key-value store. Different keys separate monitors. Do not enter tokens or secrets. FREE runs do not persist monitoring state." }, "onlyNewComments": { "title": "Return only newly observed comments (paying users only; monitor key required)", "type": "boolean", "description": "Only affects paid runs with monitorKey: suppress comment IDs in that monitor's retained baseline of up to 50,000 comment IDs per brand, not full history. An older ID outside the retained baseline can be delivered again. New means newly observed in the sample, not necessarily newly published. Has no effect on ordinary one-off or FREE runs." } } }, "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 } } } } } } } } } }