{ "openapi": "3.0.1", "info": { "title": "Instagram, Facebook, Threads & YouTube Post Metrics", "description": "Get likes, comments, shares, views and followers from Instagram, TikTok, Facebook, Threads and YouTube post URLs in one table, with the same columns for every platform. Hidden counts are null, never a made-up zero. Export to CSV, Excel or JSON, or use the API.", "version": "0.2", "x-build-id": "GiTzNasMX7oVk9JAr" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sz022~social-post-metrics/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sz022-social-post-metrics", "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/sz022~social-post-metrics/runs": { "post": { "operationId": "runs-sync-sz022-social-post-metrics", "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/sz022~social-post-metrics/run-sync": { "post": { "operationId": "run-sync-sz022-social-post-metrics", "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": [ "postUrls" ], "properties": { "postUrls": { "title": "Post URLs", "minItems": 1, "type": "array", "description": "Public post URLs. Instagram, Facebook, Threads, TikTok and YouTube can be mixed freely in one run. Facebook accepts the {pageId}_{postId}, permalink.php, /posts/pfbid..., /reel/ and /videos/ forms. TikTok accepts video and photo links and vm.tiktok.com / vt.tiktok.com share links. YouTube accepts watch, youtu.be, /shorts/ and /live/ links.", "items": { "type": "string" } }, "fetchFollowers": { "title": "Fetch follower counts", "type": "boolean", "description": "Look up the author's follower count. This costs one extra request per account, so turn it off if you only need post metrics.", "default": true }, "abortAfterConsecutiveFailures": { "title": "Stop after this many failures in a row", "minimum": 0, "type": "integer", "description": "Ends the run early when a platform stops responding, so a broken run cannot burn through your whole list. Set to 0 to never stop early.", "default": 5 }, "debugSaveHtml": { "title": "Save raw HTML on failure (debug)", "type": "boolean", "description": "Store the raw response of failed URLs in the key-value store. For diagnosing why a proxy or platform change broke extraction.", "default": false }, "proxyConfiguration": { "title": "Proxy for Instagram, Threads and YouTube", "type": "object", "description": "Datacenter proxies are enough for these platforms and cost a fraction of residential. YouTube always reads through Apify's datacenter proxy, even if a residential group is chosen here.", "default": { "useApifyProxy": true } }, "facebookProxyConfiguration": { "title": "Proxy for Facebook", "type": "object", "description": "Facebook serves a login wall to datacenter IPs, so it needs residential proxies. This only applies to Facebook URLs, so Instagram and Threads in the same run stay on the cheap proxy.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }, "tiktokProxyConfiguration": { "title": "Proxy for TikTok", "type": "object", "description": "TikTok is strict with datacenter IPs, so this defaults to residential. It only applies to TikTok URLs and is not used at all by a run without one.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }