{ "openapi": "3.0.1", "info": { "title": "📈 Instagram Profile Stats & Growth Tracker", "description": "Scrape Instagram follower counts with the Instagram Followers Count Scraper. Retrieve usernames, full names, and precise follower numbers. Ideal for influencer analysis, audience insights, and social media research. Fast, reliable, and scalable for single or bulk profiles.", "version": "1.0", "x-build-id": "qElnKK12LpE68Epmb" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapier~instagram-followers-count-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapier-instagram-followers-count-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-followers-count-scraper/runs": { "post": { "operationId": "runs-sync-scrapier-instagram-followers-count-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-followers-count-scraper/run-sync": { "post": { "operationId": "run-sync-scrapier-instagram-followers-count-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" ], "properties": { "urls": { "title": "👤 Instagram URLs or Usernames", "type": "array", "description": "Instagram profiles to scrape. Accepts full URLs (https://instagram.com/username), plain usernames, and @handles. Duplicates are removed case-insensitively. Example: [\"humansofny\", \"https://instagram.com/natgeo\", \"@cristiano\"].", "items": { "type": "string" } }, "enableHistory": { "title": "🕓 Enable follower-growth tracking", "type": "boolean", "description": "When ON, each username's follower count is snapshotted to a named Key-Value Store. On later runs the actor computes followersDelta, growthPct, dailyAvgGrowth and previousSnapshotAt vs the last stored snapshot. First run for a username returns null for these (never fabricated). Default is true.", "default": true }, "historyStoreName": { "title": "🗄️ History store name", "type": "string", "description": "Name of the persistent (named) Key-Value Store used for follower snapshots. Reuse the same name across runs to accumulate history. Example: instagram-followers-history.", "default": "instagram-followers-history" }, "concurrency": { "title": "⚡ Concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "Number of profiles fetched in parallel (each on a fresh proxy IP + fresh Chrome TLS client). Keep it conservative to avoid Instagram rate-limits. Example: 2 processes two profiles at a time. Default is 2.", "default": 2 }, "maxRetries": { "title": "🔁 Max retries", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many times to retry fetching a profile page before recording an error row for it. Example: 3. Default is 3.", "default": 3 }, "delayMs": { "title": "⏳ Delay between requests (ms)", "minimum": 0, "maximum": 60000, "type": "integer", "description": "Base delay in milliseconds used for the per-profile jitter and the retry back-off. Example: 2000 = up to a ~2s jitter before each profile. Default is 2000.", "default": 2000 }, "proxyConfiguration": { "title": "🌐 Proxy configuration", "type": "object", "description": "Proxy settings. RESIDENTIAL proxies are strongly recommended — Instagram blocks most datacenter IPs. A fresh proxy IP is used per profile." } } }, "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 } } } } } } } } } }