{ "openapi": "3.0.1", "info": { "title": "Instagram Followers And Following Scrapper", "description": "Instagram Followers & Following Scraper: Extract follower and following profiles with usernames, names, bios, follower counts, profile URLs, and available public details. Build structured datasets for audience research, influencer discovery, competitor analysis, and social media intelligence.", "version": "0.1", "x-build-id": "EV2HCq7cL2pSm2obm" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapier~instagram-followers-and-following-scrapper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapier-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/scrapier~instagram-followers-and-following-scrapper/runs": { "post": { "operationId": "runs-sync-scrapier-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/scrapier~instagram-followers-and-following-scrapper/run-sync": { "post": { "operationId": "run-sync-scrapier-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 }, "pageSize": { "title": "šŸ“„ API Page Size", "minimum": 1, "maximum": 50, "type": "integer", "description": "šŸ”§ Advanced tuning: number of users requested per Instagram API page. Higher values mean fewer HTTP requests per profile but a bigger single response.\n\nšŸ’” Default: 12 (Instagram's own typical page size). Most users can leave this alone.", "default": 12 }, "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 } } } } } } } } } }