{ "openapi": "3.0.1", "info": { "title": "Instagram Followers Scraper: Multi-Profile Analysis", "description": "Scrape Instagram follower data instantly with this Instagram Followers Scraper šŸ‘„ Extract usernames, profile links, follower counts, bios, and audience insights with ease šŸ“Š Perfect for influencer research, competitor analysis, brand monitoring, and growth tracking šŸ”šŸš€", "version": "0.1", "x-build-id": "zCXKvk0Z6LFwhn3jQ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapio~instagram-followers-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapio-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/scrapio~instagram-followers-scraper/runs": { "post": { "operationId": "runs-sync-scrapio-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/scrapio~instagram-followers-scraper/run-sync": { "post": { "operationId": "run-sync-scrapio-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", "required": [ "startUrls" ], "properties": { "startUrls": { "title": "šŸŽÆ Target Instagram Profiles (2+ for overlap analysis)", "type": "array", "description": "Add the Instagram profile URLs or usernames you want to compare. Accepts URLs or bare usernames, and the same {\"url\": \"...\"} object shape as the base Instagram Followers Scraper.\n\nExamples:\nā€¢ https://www.instagram.com/cristiano/\nā€¢ https://www.instagram.com/nike/\nā€¢ cristiano\nā€¢ nike\n\nAdd 2 or more profiles here to unlock the shared-follower overlap summary and the profile-pair overlap matrix. A single profile just scrapes followers normally.", "items": { "type": "string" } }, "maxData": { "title": "šŸ“Š Maximum Followers per Profile", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Maximum number of followers to collect per profile (1-100,000). Overlap analysis only considers followers actually collected in this run per profile, so a higher value here surfaces more (and more accurate) overlap. Default: 100.", "default": 100 }, "computeOverlap": { "title": "šŸ”€ Compute Cross-Profile Overlap", "type": "boolean", "description": "When ON (default) and 2+ profiles are supplied, the actor emits: (1) an overlap-summary dataset listing every follower username shared between 2+ of your input profiles, with which profiles it's shared between, and (2) a profile-pair overlap matrix dataset with shared-follower counts for every profile pair. Turn OFF to only collect the base follower rows.", "default": true }, "minSharedProfiles": { "title": "šŸ”¢ Minimum Profiles a Follower Must Be Shared Between", "minimum": 2, "type": "integer", "description": "A follower username must appear in at least this many of your input profiles' follower lists to be included in the overlap-summary dataset. Default 2 (any overlap). Raise this (e.g. 3) when comparing many profiles to surface only the most broadly shared audience.", "default": 2 }, "sessionId": { "title": "šŸŖ Instagram sessionid (required for real followers)", "type": "string", "description": "Instagram's followers-list API requires an authenticated session. Without a valid, currently-active sessionid, the followers endpoint returns 401 Unauthorized and the actor falls back to padding results from post commenters (tagged sourceType=comment_fallback) or returns 0 rows.\n\nHow 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\nThe cookie must belong to a currently logged-in session (Instagram invalidates old/flagged sessions). Stored and displayed as a secret." }, "proxyConfiguration": { "title": "šŸŒ Proxy Configuration", "type": "object", "description": "Configure proxy settings for enhanced reliability and bypassing restrictions.\n\nSmart fallback: 1) no proxy (default), 2) datacenter proxy if configured, 3) automatic residential-proxy escalation if requests get blocked (with retries)." } } }, "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 } } } } } } } } } }