{ "openapi": "3.0.1", "info": { "title": "Instagram Followers Count: Multiple Accounts Follower Counts", "description": "Instagram Followers Count scraper retrieves follower counts for multiple public Instagram accounts in bulk. Collect usernames, profile URLs, and follower totals to compare audience size, track growth, and support influencer, competitor, and social media research.", "version": "0.1", "x-build-id": "Uki5vJNo2FNGvEgjQ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapio~instagram-followers-count-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapio-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/scrapio~instagram-followers-count-scraper/runs": { "post": { "operationId": "runs-sync-scrapio-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/scrapio~instagram-followers-count-scraper/run-sync": { "post": { "operationId": "run-sync-scrapio-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", "properties": { "watchlistAccounts": { "title": "📈 Instagram Accounts to Track", "type": "array", "description": "Instagram profiles to monitor for growth. Accepts full URLs (https://instagram.com/natgeo), plain usernames, and @handles. Re-run this actor over time (e.g. on a schedule) to accumulate growth. Also accepts the base key 'urls'.", "items": { "type": "string" } }, "watchlistName": { "title": "🗃️ Watchlist Store Name", "type": "string", "description": "Name of the persistent (named) key-value store that holds each profile's last snapshot between runs. Keep the SAME name across runs of the same watchlist so growth accumulates. Different name = independent, fresh baseline.", "default": "instagram-growth-watchlist" }, "minGrowthPercent": { "title": "🔔 Minimum Follower Growth %", "minimum": 0, "type": "integer", "description": "Only emit a profile whose absolute follower change since the last snapshot is at least this percent. Example: 5 = report only profiles that gained or lost ≥5% followers. 0 = emit all. Ignored on baseline runs.", "default": 0 }, "onlyChanged": { "title": "🔕 Only Changed Profiles", "type": "boolean", "description": "When on, skip profiles whose followers, following AND posts are all unchanged since the last snapshot. Useful for schedule + webhook alerting. Baseline runs always emit.", "default": false }, "previousSnapshotDatasetId": { "title": "🗂️ Previous Snapshot Dataset ID", "type": "string", "description": "Optional. Dataset ID of a previous run's output. When a profile appears in it, deltas are computed against that dataset instead of the named store. Leave empty to use the persistent watchlist store." }, "maxHistory": { "title": "📚 History Points to Keep", "minimum": 0, "type": "integer", "description": "How many past snapshot points to retain per profile inside the persistent store and mirror in the output 'history' field. Default 30.", "default": 30 }, "proxyConfiguration": { "title": "🌐 Proxy Configuration", "type": "object", "description": "Residential proxy is recommended for reliable Instagram access at scale." } } }, "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 } } } } } } } } } }