{ "openapi": "3.0.1", "info": { "title": "X (Twitter) Followers & Following Scraper", "description": "Export X (Twitter) followers and following lists plus profiles in bulk: username, bio, follower count, verified type, location and website, with the source account on every row. Optional min-follower and verified-only filters skip rows before they are charged. No login needed.", "version": "0.1", "x-build-id": "hQaF07o9BucelYNz9" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/khadinakbar~twitter-profile-followers-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-khadinakbar-twitter-profile-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/khadinakbar~twitter-profile-followers-scraper/runs": { "post": { "operationId": "runs-sync-khadinakbar-twitter-profile-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/khadinakbar~twitter-profile-followers-scraper/run-sync": { "post": { "operationId": "run-sync-khadinakbar-twitter-profile-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": { "usernames": { "title": "Twitter/X Usernames", "type": "array", "description": "Use this when the user provides @handles or usernames (without @). E.g. ['elonmusk', 'sama', 'naval']. Do NOT use this when the user provides full URLs — use startUrls instead.", "items": { "type": "string" } }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Use this when the user provides full Twitter/X URLs. Supports profile URLs (x.com/username), followers URLs (x.com/username/followers), or following URLs (x.com/username/following). Overrides 'usernames' input.", "items": { "type": "object" } }, "mode": { "title": "Scrape Mode", "enum": [ "profiles", "followers", "following", "all" ], "type": "string", "description": "Choose what to scrape. 'profiles' = profile metadata only. 'followers' = follower list only. 'following' = following list only. 'all' = profile + followers + following in one run.", "default": "profiles" }, "maxFollowersPerUser": { "title": "Max Followers per User", "minimum": 0, "type": "integer", "description": "Maximum number of followers to collect per account. Use this to control cost. Default: 200. Set to 0 for unlimited (warning: large accounts have millions).", "default": 200 }, "maxFollowingPerUser": { "title": "Max Following per User", "minimum": 0, "type": "integer", "description": "Maximum number of following accounts to collect per user. Default: 200. Set to 0 for unlimited.", "default": 200 }, "maxResults": { "title": "Max Total Results", "minimum": 0, "type": "integer", "description": "Hard cap on total records returned across all users and modes. Use to control costs. Default: 1000. Set to 0 for no limit.", "default": 1000 }, "minFollowers": { "title": "Min followers (follower/following rows)", "minimum": 0, "type": "integer", "description": "Only keep follower and following rows whose own follower count is at least this number. Rows below the threshold are skipped and are not charged. Profile rows for the target accounts are always returned. Default 0 keeps every row.", "default": 0 }, "verifiedOnly": { "title": "Verified accounts only (follower/following rows)", "type": "boolean", "description": "When true, only keep follower and following rows that carry a verification badge (legacy, blue, business or government). Skipped rows are not charged. Profile rows are always returned. Default false.", "default": false }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings for scraping. Residential proxies recommended for Twitter/X. Leave as default unless you have specific proxy requirements." } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }