{ "openapi": "3.0.1", "info": { "title": "Instagram Followers & Following — Real Lists, Not Counts", "description": "Export any Instagram account's followers or following list to structured JSON/CSV: username, name, ID, verified & private flags, profile link. Instagram gates these lists behind login, so this actor uses YOUR OWN session cookie (never ours) to paginate safely. MCP-ready.", "version": "0.1", "x-build-id": "lsqYg5NdJTGIXteZd" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/themineworks~instagram-followers-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-themineworks-instagram-followers-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/themineworks~instagram-followers-scraper/runs": { "post": { "operationId": "runs-sync-themineworks-instagram-followers-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/themineworks~instagram-followers-scraper/run-sync": { "post": { "operationId": "run-sync-themineworks-instagram-followers-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": { "usernames": { "title": "Target usernames", "type": "array", "description": "Instagram usernames (without the @) whose followers/following you want to export. Full profile URLs also work. Each is scraped independently.", "items": { "type": "string" } }, "username": { "title": "Single target username (optional)", "type": "string", "description": "Convenience field for one target. If set, it is added to Target usernames above." }, "mode": { "title": "What to export", "enum": [ "followers", "following", "both" ], "type": "string", "description": "Followers = accounts that follow the target. Following = accounts the target follows. Both = one run for each, tagged by the relation field.", "default": "followers" }, "sessionid": { "title": "Your Instagram sessionid cookie (required for real data)", "type": "string", "description": "REQUIRED to get any followers/following data. Instagram only serves these lists to a logged-in session — there is no public, no-login route to them (unlike our Instagram Profile Scraper, which needs no login). Log into instagram.com in a normal browser, open DevTools → Application/Storage → Cookies → instagram.com, and copy the value of the 'sessionid' cookie. It is used ONLY for the API calls this run makes and is never logged, stored, or sent anywhere else. Use a secondary/throwaway Instagram account if possible — bulk pagination on a real session carries real account risk (rate-limit, checkpoint, or temporary block) per Instagram's Terms of Use. Leave blank to see exactly how the actor behaves without one (it will explain the requirement and exit cleanly with zero charge, not fabricate data)." }, "csrftoken": { "title": "csrftoken cookie (optional, advanced)", "type": "string", "description": "Optional. The 'csrftoken' cookie value from the same browser session as your sessionid. Not required for the read-only calls this actor makes, but supplying the real value from your session is the safest match to genuine browser traffic. If left blank, a syntactically valid placeholder is generated for you." }, "maxPerUsername": { "title": "Max rows per username per relation", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Stop paginating a given username/relation after this many rows. Hard-capped at 5000 regardless of what you enter here, as a cost/safety ceiling.", "default": 200 }, "startCursor": { "title": "Resume cursor (optional, advanced)", "type": "string", "description": "Advanced / single-target runs only. If a previous run stopped early (cap reached) it prints a 'next_cursor' value in its final summary row — paste it here to continue from that point instead of the beginning. Ignored when more than one target username is supplied." }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Residential proxy is required — Instagram blocks most datacenter ranges outright, authenticated session or not. The whole run reuses ONE fixed proxy session (not a fresh IP per request) so your login looks like a single consistent client to Instagram, not an account being accessed from many countries at once. Leave as default." } } }, "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 } } } } } } } } } }