{ "openapi": "3.0.1", "info": { "title": "Instagram Post Likers Scraper — Who Liked Any Public Post", "description": "Scrape the accounts that liked an Instagram post or reel — username, full name, user id, profile link, picture, verified and private flags. Paste links, codes or media ids. No login. About 1,000 likers per post per read, ~2,000 at most. Re-runs never charge a liker twice. From $0.40 per 1,000.", "version": "1.0", "x-build-id": "XGOpOakvjnPeMt2tk" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/steadyfetch~instagram-post-likers-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-steadyfetch-instagram-post-likers-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/steadyfetch~instagram-post-likers-scraper/runs": { "post": { "operationId": "runs-sync-steadyfetch-instagram-post-likers-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/steadyfetch~instagram-post-likers-scraper/run-sync": { "post": { "operationId": "run-sync-steadyfetch-instagram-post-likers-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": { "postUrls": { "title": "Post URLs", "type": "array", "description": "Instagram post, reel or IGTV links, the bare code at the end of one, or the post's 19-digit Instagram media id, e.g. [\"https://www.instagram.com/p/DcOX3hWFiey/\", \"DdG2ps5y5-l\"]; \"_demo\" is the sample switch, not a link. Never charged: a link that does not resolve, a deleted or private post, and a liker this account already has. A profile or hashtag link is refused with an uncharged row naming the actor that takes it. Leave it untouched and click Start for built-in sample rows, at no result fee.", "default": [ "_demo" ], "items": { "type": "string" } }, "maxLikersPerPost": { "title": "Max likers per post", "minimum": 1, "type": "integer", "description": "Hard cap on the likers delivered for EACH post, a whole number up to 2,000, e.g. 500 — three posts at 500 collect up to 1,500 in total. One read of a post's likers list serves about 1,000 accounts, sometimes a few hundred more, and 2,000 is the most this actor can deliver for one post: ask for more and the run continues at 2,000, with one uncharged row saying so, rather than being refused. A post that runs short leaves one uncharged row with the numbers.", "default": 2000 }, "maxItems": { "title": "Max likers in total", "minimum": 1, "type": "integer", "description": "Optional cap on the likers delivered across the WHOLE run, a whole number, e.g. 1000, on top of the per-post limit. Leave it empty for no run-wide cap. Posts the run did not reach because this cap was full each get one uncharged row saying so. Likers handed back from your account's memory count against it like any other row." }, "maxRunSeconds": { "title": "Max run seconds", "type": "integer", "description": "Max run seconds, a whole number from 30 to 3,600, e.g. 600 — the run stops cleanly before this many seconds and reports what is left, instead of being killed by a timeout. A time limit ends the collecting, never the delivering: likers already in hand are always written out. The clock runs between 30 seconds and 1 hour: set it outside that and the run continues at the nearest one, with one uncharged row saying so, rather than being refused.", "default": 600 }, "includeSeen": { "title": "Include likers you already have", "type": "boolean", "description": "A switch, true (default) or false. ON: a liker already delivered to your account for that post is delivered again, marked `repeat: true`, and NOT charged, so each run hands you the post's whole current list. OFF: those likers are skipped — no row, no charge — and the post's status row counts them. Likers older than 90 days in your account's memory count as new again either way.", "default": true }, "resumeFromDatasetId": { "title": "Skip likers in this dataset", "type": "string", "description": "Dataset ID of a previous run of this actor, e.g. the 17-character ID on that run's Storage tab: likers already in it are never charged again, so a follow-up run pays only for new likers. It works even from a different Apify account. Selecting it here is what grants this run permission to read it." } } }, "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 } } } } } } } } } }