{ "openapi": "3.0.1", "info": { "title": "X (Twitter) Profile Scraper — Accounts, Activity & Growth", "description": "One row per X account: followers, following, posts, bio, website, location, verification, account age — plus what X does not state: posting cadence, average and median engagement, top post, and the follower change since your last run. No login, no API key.", "version": "0.1", "x-build-id": "bYtekY18zmjRCNl2y" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/foxlabs~x-profile-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-foxlabs-x-profile-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/foxlabs~x-profile-scraper/runs": { "post": { "operationId": "runs-sync-foxlabs-x-profile-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/foxlabs~x-profile-scraper/run-sync": { "post": { "operationId": "run-sync-foxlabs-x-profile-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": [ "accounts" ], "properties": { "accounts": { "title": "X accounts", "type": "array", "description": "One account per line: a handle (@nasa), a profile address (x.com/nasa) or the account's numeric id (11348282). A numeric id is the cheapest to read; a handle is looked up once and then remembered as its id.", "default": [ "@NASA" ], "items": { "type": "string" } }, "includeActivity": { "title": "Measure the account's activity", "type": "boolean", "description": "Adds what X does not state, computed from the page of newest posts the same read already brings: posts per day, the days the page spans, days since the last post, average and median engagement, engagement per 1,000 followers, the top post, the languages it posts in, the share of posts with media, links, hashtags and replies, and the accounts it mentions most.", "default": true }, "trackGrowth": { "title": "Say what changed since the last run", "type": "boolean", "description": "Keeps each account's counts in a key-value store of your own account, so the next run can state the follower change, the change per day, the percentage change, and how many posts were added since. The first run of an account says so instead of writing zeros.", "default": true }, "historyStore": { "title": "Store for the growth history", "type": "string", "description": "Name of the key-value store that holds the counts last seen per account. Use separate stores for separate watchlists if you want their histories kept apart.", "default": "x-profile-history" }, "minFollowers": { "title": "Minimum followers", "minimum": 0, "type": "integer", "description": "An account under this is not delivered and not charged — useful when a list mixes real accounts with empty ones.", "default": 0 }, "onlyVerified": { "title": "Verified accounts only", "type": "boolean", "description": "Leaves out accounts X does not mark as verified. Not delivered means not charged.", "default": false }, "activeWithinDays": { "title": "Only accounts that posted in the last N days", "minimum": 0, "maximum": 3650, "type": "integer", "description": "0 means no limit. Measured on the newest post X embeds for the account; an account with nothing embedded is reported as a free status row.", "default": 0 }, "maxAccounts": { "title": "Maximum rows in the whole run", "minimum": 0, "type": "integer", "description": "A cost cap. 0 means every account in the list is read.", "default": 0 }, "concurrency": { "title": "Accounts read at the same time", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many accounts are read side by side. Measured on the platform 2026-10-19: ten accounts read eight at a time met X's rate limit and half of them came back empty, while three at a time delivered all ten. Three is therefore the default; raising it makes a run faster and more likely to need the second pass.", "default": 3 }, "rememberAccountIds": { "title": "Remember handles as numeric ids", "type": "boolean", "description": "After an account named by handle has been read once, its numeric id is kept in a key-value store of your account, and later runs read it the cheap way. Turn off to look every handle up again.", "default": true }, "accountIdStore": { "title": "Store for the remembered ids", "type": "string", "description": "Name of the key-value store that holds the handle → id pairs. It belongs to this Actor: a store another Actor created cannot be opened from here, and if the name you give cannot be opened the run still delivers its rows and says so.", "default": "x-profile-account-ids" }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Left as it is, the Actor uses Apify Proxy datacenter addresses, which X's embed backend answers for everything read by numeric id. Accounts named by handle are looked up through residential addresses, because a handle lookup from a datacenter address is rate-limited.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }