{ "openapi": "3.0.1", "info": { "title": "Instagram Followers And Following Scrapper", "description": "Extract followers and following lists from Instagram profiles with this scraper. Collect usernames, profile links, display names, and account details. Useful for audience research, influencer analysis, competitor monitoring, and tracking community growth on Instagram profiles.", "version": "0.1", "x-build-id": "oVMAi0UoJ0uDhNEiA" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scraper-engine~instagram-followers-and-following-scrapper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scraper-engine-instagram-followers-and-following-scrapper", "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/scraper-engine~instagram-followers-and-following-scrapper/runs": { "post": { "operationId": "runs-sync-scraper-engine-instagram-followers-and-following-scrapper", "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/scraper-engine~instagram-followers-and-following-scrapper/run-sync": { "post": { "operationId": "run-sync-scraper-engine-instagram-followers-and-following-scrapper", "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": [ "scrapeMode", "startUrls" ], "properties": { "startUrls": { "title": "šŸ“‹ Instagram Profile URLs or Usernames", "type": "array", "description": "šŸ“‹ List of Instagram profile URLs or usernames to scrape.\n\nšŸ’” Examples:\nā€¢ https://www.instagram.com/cristiano/\nā€¢ https://www.instagram.com/nike/\nā€¢ cristiano\nā€¢ nike\n\nāœØ You can add multiple profiles to scrape in one run!", "items": { "type": "string" } }, "scrapeMode": { "title": "šŸŽÆ Scrape Mode", "enum": [ "followers", "following" ], "type": "string", "description": "Choose what to scrape:\nā€¢ followers - Scrape followers of the profiles\nā€¢ following - Scrape accounts that the profiles are following", "default": "followers" }, "maxData": { "title": "šŸ“Š Maximum Items per Profile", "minimum": 0, "maximum": 100000, "type": "integer", "description": "šŸŽÆ Set the maximum number of items to collect per profile.\n\nšŸ“ˆ Range: 0-100,000 items\nšŸ’” Default: 100 items (recommended for faster results)\n\nāš” Tip: Lower values = faster scraping, Higher values = more comprehensive results\n\nNote: 0 = unlimited (collect until pagination ends)", "default": 100 }, "sessionId": { "title": "šŸŖ Instagram sessionid (recommended)", "type": "string", "description": "šŸ” Optional but strongly recommended for better success rates.\n\nšŸ“ How to get your Session ID:\n1. Log into Instagram in your browser\n2. Open Developer Tools (F12 or Right-click ā†’ Inspect)\n3. Go to Application/Storage ā†’ Cookies ā†’ https://www.instagram.com\n4. Find and copy the 'sessionid' value\n\nšŸ’” Example format: 80339464000%3AMwlUEdZkdshtFG%3A5%3AAYiJEi32U_OOJkvXyc232wBhDZz1Q4zQOFhTFSTy3g\n\nāš ļø Note: Without a session ID, the scraper may have limited access and lower success rates." }, "proxyConfiguration": { "title": "šŸ”’ Proxy Configuration", "type": "object", "description": "šŸ›”ļø Configure proxy settings for enhanced reliability and bypassing restrictions.\n\nšŸ”„ Smart Fallback System:\n1ļøāƒ£ No proxy (default) - Direct connection\n2ļøāƒ£ Datacenter proxy - If configured\n3ļøāƒ£ Residential proxy - Automatic fallback if blocked\n\nāœ… The actor automatically switches to residential proxy if requests are blocked (with 3 retries).\n\nšŸ’” Recommended: Enable proxy for better success rates!" } } }, "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 } } } } } } } } } }