{ "openapi": "3.0.1", "info": { "title": "Instagram Followers Scraper & Related Profile Expansion", "description": "📸 Instagram Followers Enrichment Scraper extracts public follower lists from any IG profile—usernames, names, bios, follower/following, verification & profile links. ⚡ Export CSV/JSON for growth, competitor research, influencer discovery & lead gen. ✅ Fast, accurate, scalable.", "version": "0.1", "x-build-id": "lWyBvLuf2VW3bFEkD" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/simpleapi~instagram-followers-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-simpleapi-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/simpleapi~instagram-followers-scraper/runs": { "post": { "operationId": "runs-sync-simpleapi-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/simpleapi~instagram-followers-scraper/run-sync": { "post": { "operationId": "run-sync-simpleapi-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": { "targetProfiles": { "title": "🎯 Instagram Profiles to Analyze", "type": "array", "description": "List of Instagram profile URLs or usernames. Followers are collected for each, and related/suggested profiles are discovered and audience-fit scored against it.\n\nExamples:\n• https://www.instagram.com/cristiano/\n• https://www.instagram.com/nike/\n• cristiano\n• nike\n\nAlso accepts the base field name 'startUrls' for backward compatibility.", "items": { "type": "string" } }, "maxFollowersPerProfile": { "title": "📊 Max Followers to Collect per Seed Profile", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Maximum number of followers to collect per seed profile. Range: 1-100,000. Default: 100.\n\nAlso accepts the base field name 'maxData' for backward compatibility." }, "enableRelatedProfileScoring": { "title": "🧮 Enable Related-Profile Audience-Fit Scoring", "type": "boolean", "description": "When ON, for each seed profile the actor fetches its related/suggested profiles (via Instagram's edge_related_profiles/edge_chaining), samples each related profile's own followers, and computes what percentage of that sample also follows the seed (sharedAudiencePct). Output rows are ranked by sharedAudiencePct descending.", "default": true }, "maxRelatedToScore": { "title": "🧭 Max Related Profiles to Score per Seed", "minimum": 1, "maximum": 50, "type": "integer", "description": "Caps how many of a seed's related/suggested profiles get their followers sampled and scored (1 request per seed for discovery, plus 1 follower-sample request per related profile checked, up to this cap). Default: 10.", "default": 10 }, "relatedFollowerSampleSize": { "title": "📥 Follower Sample Size per Related Profile", "minimum": 10, "maximum": 200, "type": "integer", "description": "How many of EACH related profile's own followers to fetch (single page, via the same followers engine used for seed profiles) to check for overlap with the seed's follower list. Default: 50.", "default": 50 }, "instagramSessionId": { "title": "🍪 Instagram sessionid (recommended)", "type": "string", "description": "Optional but strongly recommended for better success rates.\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\nWithout a session ID, the scraper may have limited access and lower success rates.\n\nAlso accepts the base field name 'sessionId' for backward compatibility." }, "proxyConfiguration": { "title": "🔒 Proxy Configuration", "type": "object", "description": "Configure proxy settings for enhanced reliability and bypassing restrictions.\n\nSmart fallback: no proxy → datacenter proxy (if configured) → residential proxy (automatic on block, 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 } } } } } } } } } }