{ "openapi": "3.0.1", "info": { "title": "Instagram Followers Scraper: Daily Follower Counts", "description": "Instagram Followers Scraper: Track daily follower counts and profile growth over time. Collect usernames, profile URLs, follower totals, dates, and growth metrics to monitor audience trends, benchmark creators, analyze competitors, and measure social media performance.", "version": "0.1", "x-build-id": "71Z3d2b5nQV0Ub3jr" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/api-empire~instagram-followers-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-api-empire-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/api-empire~instagram-followers-scraper/runs": { "post": { "operationId": "runs-sync-api-empire-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/api-empire~instagram-followers-scraper/run-sync": { "post": { "operationId": "run-sync-api-empire-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": "šŸ“‹ Instagram Profile URLs or Usernames", "type": "array", "description": "šŸ“‹ List of Instagram profile URLs or usernames to scrape followers from and track for growth.\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 and track in one run! Re-running with the SAME profile lets the actor diff this run's followers against the last run's snapshot.", "items": { "type": "string" } }, "maxData": { "title": "šŸ“Š Maximum Followers per Profile", "minimum": 1, "maximum": 100000, "type": "integer", "description": "šŸŽÆ Set the maximum number of followers to collect per profile.\n\nšŸ“ˆ Range: 1-100,000 followers\nšŸ’” Default: 100 followers (recommended for faster results)\n\nāš” Tip: Lower values = faster scraping, Higher values = more comprehensive results", "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. This value is kept secret and never shown once saved." }, "resetBaseline": { "title": "šŸ”„ Reset Growth Baseline", "type": "boolean", "description": "When ON, this run ignores any previously saved snapshot for the profiles above and starts a fresh baseline (as if this were the first run). Use this after deliberately changing maxData or when you want to discard prior growth history. Default OFF (diff against the last saved snapshot as normal).", "default": false }, "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 } } } } } } } } } }