{ "openapi": "3.0.1", "info": { "title": "Instagram Follower Tracker", "description": "See who follows — and who just unfollowed — any public Instagram account. Your very first run also flags who you follow that doesn't follow you back and audits your top fans and ghost followers. Put it on a schedule and each run automatically flags new followers, unfollowers, and following changes.", "version": "0.0", "x-build-id": "iSaiAosnklFB7cNP9" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/afanasenko~instagram-follower-tracker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-afanasenko-instagram-follower-tracker", "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/afanasenko~instagram-follower-tracker/runs": { "post": { "operationId": "runs-sync-afanasenko-instagram-follower-tracker", "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/afanasenko~instagram-follower-tracker/run-sync": { "post": { "operationId": "run-sync-afanasenko-instagram-follower-tracker", "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": [ "usernames" ], "properties": { "usernames": { "title": "Accounts to Track", "type": "array", "description": "Instagram accounts to monitor — one public handle or profile URL per line (e.g. `zara` or `https://instagram.com/natgeo`). Only public accounts can be tracked — Instagram hides a private account's follower list from everyone. Each run compares the account's current list against the previous run. Free plan: track 1 account, 15 runs per month; paid plans track multiple accounts and larger lists, with no run limit.", "default": [], "items": { "type": "string" } }, "trackFollowers": { "title": "Track Followers", "type": "boolean", "description": "When true, tracks each account's followers list — reports who newly followed and who unfollowed since the previous run. **Reliable up to 150,000 followers per account.** On a paid plan a bigger list is tracked on its most-recent 150,000 (charged for what's read; precise new / unfollowed can't be confirmed above that size); on the free plan a larger account's most-recent 2,500 followers are saved for you, free of charge. At least one of Track Followers / Track Following must be on.", "default": true }, "trackFollowing": { "title": "Track Following", "type": "boolean", "description": "When true, tracks each account's following list — who the target started and stopped following. **Reliable up to 1,000 following per account.** A bigger list is tracked on its most-recent 1,000 (paid: charged for what's read; free: over 1,000 is skipped, never charged) — precise new / lost can't be confirmed above that size. The following list gets **no** baseline on run 1; confirmed changes start from run 3. At least one of Track Followers / Track Following must be on.", "default": true }, "engagementAudit": { "title": "Find Top Fans & Ghost Followers", "type": "boolean", "description": "Also checks who likes and comments on the account's recent posts — your **top fans** (most engaged followers, first few names free), your **ghost followers** (never engage — exact count free, names on a paid plan), and how many non-followers engage. Runs when the followers list is fully readable; refreshed weekly; no extra charge.", "default": true }, "notificationEmail": { "title": "Your email — where the alerts are sent", "pattern": "^$|^[^@\\s]+@[^@\\s]+\\.[^@\\s]+$", "type": "string", "description": "Know the moment someone unfollows — by email. Enter the address where each new follower and unfollower should land; this is the normal way to run the tracker. (Leave blank only if you'd rather open the Apify Console Output by hand after every run.) Used only to send these alerts, then discarded — never stored or shared.", "default": "" } } }, "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 } } } } } } } } } }