{ "openapi": "3.0.1", "info": { "title": "Instagram Metrics Scraper - Posts, Reels & Profiles", "description": "Collect clean metric rows for public Instagram posts, reels, carousels, and recent profile content. Get views, plays, likes, comments, collaborators, captions, IDs, media links, and status fields without fake zeroes.", "version": "1.0", "x-build-id": "523Co9noTtkO5lstp" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/chronometrica~instagram-metrics-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-chronometrica-instagram-metrics-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/chronometrica~instagram-metrics-scraper/runs": { "post": { "operationId": "runs-sync-chronometrica-instagram-metrics-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/chronometrica~instagram-metrics-scraper/run-sync": { "post": { "operationId": "run-sync-chronometrica-instagram-metrics-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": { "mode": { "title": "Input handling", "enum": [ "auto", "contentUrls", "profileUrls" ], "type": "string", "description": "Choose how to use the inputs below. Auto-detect accepts post URLs, reel URLs, profile URLs, @handles, and shortcodes in the same list.", "default": "auto" }, "startUrls": { "title": "Instagram URLs, @handles, or shortcodes", "minItems": 0, "uniqueItems": true, "type": "array", "description": "Paste public Instagram post URLs, reel URLs, carousel URLs, profile URLs, @handles, or shortcodes. Direct inputs are normalized and the actor applies one shared metric row cap.", "items": { "type": "string", "pattern": "^\\s*(?:(?:https?:\\/\\/)?(?:(?:www\\.)?instagram\\.com)\\/\\S+|@[A-Za-z0-9._]+|[A-Za-z0-9._-]{5,})\\s*$" }, "default": [ "https://www.instagram.com/reel/DIwcCZgxVZP/" ] }, "urls": { "title": "Legacy content URLs", "type": "array", "description": "Backward-compatible hidden field for API users that send Instagram content URLs as urls.", "items": { "type": "string" }, "default": [] }, "shortcodes": { "title": "Legacy shortcodes", "type": "array", "description": "Backward-compatible hidden field for API users that send Instagram shortcodes directly.", "items": { "type": "string" }, "default": [] }, "profileUrls": { "title": "Legacy profile URLs", "type": "array", "description": "Backward-compatible hidden field for API users that send Instagram profile URLs or @handles as profileUrls.", "items": { "type": "string" }, "default": [] }, "maxItems": { "title": "Metric rows to collect (shared cap)", "minimum": 1, "type": "integer", "description": "Maximum number of Instagram metric rows to collect across direct content URLs and content discovered from profiles.", "default": 25 }, "maxItemsPerProfile": { "title": "Posts and reels to discover per profile", "minimum": 1, "type": "integer", "description": "Maximum number of public content URLs to discover from each Instagram profile URL or @handle. The shared cap still limits total output rows.", "default": 20 }, "includeProfileSnapshot": { "title": "Legacy profile option", "type": "boolean", "description": "Backward-compatible hidden field for older API users.", "default": true } } }, "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 } } } } } } } } } }