{ "openapi": "3.0.1", "info": { "title": "Instagram Following Scraper", "description": "Extract following lists from Instagram profiles with the Instagram Following Scraper. Collect usernames, profile URLs, follower counts, and other public profile details in structured format. Ideal for audience research, influencer discovery, competitor analysis, and social media insights.", "version": "0.5", "x-build-id": "RXdn6v4U8c8OPWmCx" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapier~instagram-following-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapier-instagram-following-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/scrapier~instagram-following-scraper/runs": { "post": { "operationId": "runs-sync-scrapier-instagram-following-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/scrapier~instagram-following-scraper/run-sync": { "post": { "operationId": "run-sync-scrapier-instagram-following-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": [ "urls", "sessionId" ], "properties": { "urls": { "title": "šŸ”— Profiles (URLs or usernames)", "type": "array", "description": "āœ… Full profile links work great\nāœ… Plain `@handle` or `handle` works too\nāœ… Add as many as you need for a **bulk** run\n\n*Example:* `https://www.instagram.com/mrbeast/`", "items": { "type": "string" } }, "maxItems": { "title": "šŸ“Š Max following count (per profile)", "minimum": 0, "type": "integer", "description": "šŸ”¢ **Limit** how many accounts to collect **for each** profile in your list.\n\n`0` = **no cap** (keep going until the list ends)\n\nNot sure? Start with **100ā€“500** and adjust next time. Bigger numbers = longer runs.", "default": 100 }, "skipPrivateAccounts": { "title": "šŸš« Skip private accounts", "type": "boolean", "description": "Turn on to drop every account whose profile is **private** (`is_private = true`) from the output.", "default": false }, "onlyVerifiedAccounts": { "title": "āœ… Only verified accounts", "type": "boolean", "description": "Turn on to keep **only** accounts with the blue verified badge (`is_verified = true`). Most profiles follow very few verified accounts, so combine this with a generous run-time budget.", "default": false }, "enrichProfileDetails": { "title": "šŸ“ˆ Add follower / following / post counts + bio", "type": "boolean", "description": "Adds `followersCount`, `followingCount`, `postsCount`, `biography`, `externalUrl`, `category`, `isBusiness` and public contact details to every row ā€” taken live from Instagram. If a lookup fails the row is still saved, just without these fields (never with a fake `0`).", "default": false }, "maxRunTimeSecs": { "title": "ā±ļø Run time budget (seconds)", "minimum": 60, "maximum": 86400, "type": "integer", "description": "Hard wall-clock limit for the whole scrape. When it is reached the actor stops cleanly and keeps everything collected so far, instead of running into the platform timeout.", "default": 3600 }, "sessionId": { "title": "šŸ”‘ Instagram session cookie (sessionid)", "type": "string", "description": "**REQUIRED.** Copy the `sessionid` cookie value from a browser where you are logged in to Instagram and paste it here. Without it the following endpoint returns a login wall and no data. It stays private to your run ā€” never share it publicly." }, "proxyConfiguration": { "title": "šŸ›”ļø Proxy settings", "type": "object", "description": "šŸŽ›ļø **Default:** run without a special proxy (direct). Toggle Apify Proxy here and pick the options that match your plan. RESIDENTIAL is the most reliable for Instagram at scale.", "default": { "useApifyProxy": 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 } } } } } } } } } }