{ "openapi": "3.0.1", "info": { "title": "Instagram Likes Scraper & Tagged Accounts", "description": "Instagram Likes Scraper extracts users who liked an Instagram post. Collect usernames, profile URLs, and public profile details of people who liked the post. Ideal for engagement analysis, influencer research, audience insights, and social media lead generation.", "version": "0.1", "x-build-id": "tEe5n3kVXclvkcfN7" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapapi~instagram-likes-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapapi-instagram-likes-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/scrapapi~instagram-likes-scraper/runs": { "post": { "operationId": "runs-sync-scrapapi-instagram-likes-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/scrapapi~instagram-likes-scraper/run-sync": { "post": { "operationId": "run-sync-scrapapi-instagram-likes-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", "required": [ "startUrls" ], "properties": { "startUrls": { "title": "📎 Post URLs", "type": "array", "description": "🔗 Paste one or more Instagram post URLs (e.g. https://www.instagram.com/p/XXXXX/). We'll collect likers + commenters from each.", "items": { "type": "string" } }, "maxCount": { "title": "🎯 Max users to collect", "minimum": 1, "maximum": 10000, "type": "integer", "description": "📈 Cap on unique users (likers + commenters) across all posts. 1–10,000. Default: 1000.", "default": 100 }, "sessionId": { "title": "🔐 Instagram session ID (optional)", "type": "string", "description": "Paste your Instagram sessionid cookie value for authenticated requests. Get it from browser: DevTools → Application → Cookies → instagram.com → sessionid. Without it, requests may return 0 users (login page).", "default": "" }, "proxyConfiguration": { "title": "🌐 Proxy (optional)", "type": "object", "description": "🛡️ Leave off for direct requests. If Instagram blocks you, we auto fallback: datacenter → residential (with retries)." }, "includeTaggedAccounts": { "title": "🏷️ Include tagged accounts", "type": "boolean", "description": "Also return every account tagged in the post — the accounts Instagram pins to the photo or video, including tags placed on individual carousel slides. Each one arrives as its own row with its username, display name, user id, verified and private flags and profile picture, exactly like a liker row, plus a label saying it was tagged and the tag's position on the image. Note that not every post tags anyone: across 48 real posts measured on 2026-08-15, 27 carried at least one tagged or co-author account and 21 credited nobody, in which case this adds no rows and you still get the full likers list.", "default": true }, "includeCollabAccounts": { "title": "🤝 Include Collab co-authors", "type": "boolean", "description": "Also return the co-author accounts that published the post together with the owner — Instagram's \"Collab\" — and label them so a collaborator is distinguishable from a plain tag. Measured on 48 real posts: 21 carried at least one co-author, 31 co-author entries in total, and in that sample every co-author was also tagged on the post — so this field mainly tells you which of the credited accounts is a publishing partner rather than a mention, and rarely adds an account the tag list did not already have.", "default": true }, "creditedAccountsOnly": { "title": "🎯 Only credited accounts", "type": "boolean", "description": "Return only the credited accounts and skip the likers list entirely. Turn this on when you are auditing many posts and want a partner shortlist rather than tens of thousands of liker rows — a 50-post run drops from roughly 50,000 rows to a few dozen, and skips about 800 KB of liker payload per post. Leave it off (the default) to get the base actor's full likers and commenters list with the credited accounts added on top; that also means a post that credits nobody still returns its likers instead of nothing at all.", "default": false } } }, "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 } } } } } } } } } }