{ "openapi": "3.0.1", "info": { "title": "X (Twitter) Profile Scraper - Followers, Bio & Tweets", "description": "X (Twitter) profile scraper: get Twitter user info for any handle (followers, following, bio, links, location, join date, verification, affiliation, category) plus their latest tweets with likes, retweets and views. No login, no API key. $0.14 per 1,000 profiles.", "version": "0.1", "x-build-id": "Dmbq8bzWgEfy3SBmA" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/socialscrapers~x-profile-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-socialscrapers-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/socialscrapers~x-profile-scraper/runs": { "post": { "operationId": "runs-sync-socialscrapers-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/socialscrapers~x-profile-scraper/run-sync": { "post": { "operationId": "run-sync-socialscrapers-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": [ "handles" ], "properties": { "handles": { "title": "X handles or profile URLs", "type": "array", "description": "One per line: a handle (NASA or @NASA) or a profile URL (https://x.com/NASA, https://twitter.com/NASA). A post link reads its author, and t.co short links are followed to the profile or post they lead to. Duplicates are read once. Example: NASA", "items": { "type": "string" } }, "maxTweetsPerProfile": { "title": "Latest posts per profile", "minimum": 0, "type": "integer", "description": "Also save each profile's latest posts (newest first) inside its item, under latestTweets: full text, date, likes, reposts, replies, views, media and the reposted or quoted post. 0 saves the profile only. Example: 20. Reposts and the owner's own threads are included; replies to other accounts are not shown to logged-out visitors.", "default": 0 }, "onlyTweetsNewerThan": { "title": "Only posts newer than", "pattern": "^\\s*(?:(?:[tT][oO][dD][aA][yY]|[yY][eE][sS][tT][eE][rR][dD][aA][yY]|[nN][oO][wW])|(?:(?:(?:[tT][hH][eE]\\s+)?(?:[lL][aA][sS][tT]|[pP][aA][sS][tT]|[pP][rR][eE][vV][iI][oO][uU][sS])\\s+)?(?:[-+]\\s*)?(?:\\d{1,5})\\s*|(?:[tT][hH][eE]\\s+)?(?:[lL][aA][sS][tT]|[pP][aA][sS][tT]|[pP][rR][eE][vV][iI][oO][uU][sS])\\s+|[aA][nN]?\\s+)(?:[mM][iI][nN][uU][tT][eE][sS]?|[mM][iI][nN][sS]?|[hH][oO][uU][rR][sS]?|[hH][rR][sS]?|[hH]|[dD][aA][yY][sS]?|[dD]|[wW][eE][eE][kK][sS]?|[wW][kK][sS]?|[wW]|[mM][oO][nN][tT][hH][sS]?|[mM][oO][sS]?|[mM][tT][hH][sS]?|[mM][oO][nN][sS]?|[yY][eE][aA][rR][sS]?|[yY][rR][sS]?|[yY])(?:\\s+[aA][gG][oO])?|(?:(?:19|20)\\d\\d)[-/.](?:0?[1-9]|1[0-2])[-/.](?:0?[1-9]|[12]\\d|3[01])(?:(?:[tT]|\\s+|\\s*,\\s*)(?:[01]?\\d|2[0-3]):(?:[0-5]\\d)(?::(?:[0-5]\\d)(?:[.,](?:\\d{1,9}))?)?\\s*(?:[zZ]|[uU][tT][cC]|[gG][mM][tT]|[+-](?:[01]\\d|2[0-3])(?::?[0-5]\\d)?)?)?|(?:(?:19|20)\\d\\d)(?:0[1-9]|1[0-2])(?:0[1-9]|[12]\\d|3[01])|(?:(?:19|20)\\d\\d)[-/.](?:0?[1-9]|1[0-2])|(?:(?:19|20)\\d\\d)|(?:1[3-9]|2\\d|3[01])[-/.](?:0?[1-9]|1[0-2])[-/.](?:(?:19|20)\\d\\d)|(?:0?[1-9]|1[0-2])[-/.](?:0?[1-9]|[12]\\d|3[01])[-/.](?:(?:19|20)\\d\\d)|(?:(?:[mM][oO][nN](?:[dD][aA][yY])?|[tT][uU][eE](?:[sS](?:[dD][aA][yY])?)?|[wW][eE][dD](?:[nN][eE][sS][dD][aA][yY])?|[tT][hH][uU](?:[rR](?:[sS](?:[dD][aA][yY])?)?)?|[fF][rR][iI](?:[dD][aA][yY])?|[sS][aA][tT](?:[uU][rR][dD][aA][yY])?|[sS][uU][nN](?:[dD][aA][yY])?)[\\s,.]+)?(?:(?:[jJ][aA][nN](?:[uU][aA][rR][yY])?|[fF][eE][bB](?:[rR][uU][aA][rR][yY])?|[mM][aA][rR](?:[cC][hH])?|[aA][pP][rR](?:[iI][lL])?|[mM][aA][yY]|[jJ][uU][nN][eE]?|[jJ][uU][lL][yY]?|[aA][uU][gG](?:[uU][sS][tT])?|[sS][eE][pP](?:[tT](?:[eE][mM][bB][eE][rR])?)?|[oO][cC][tT](?:[oO][bB][eE][rR])?|[nN][oO][vV](?:[eE][mM][bB][eE][rR])?|[dD][eE][cC](?:[eE][mM][bB][eE][rR])?)[\\s,./-]*(?:(?:0?[1-9]|[12]\\d|3[01])(?:[sS][tT]|[nN][dD]|[rR][dD]|[tT][hH])?[\\s,./-]+)?|(?:0?[1-9]|[12]\\d|3[01])(?:[sS][tT]|[nN][dD]|[rR][dD]|[tT][hH])?[\\s,./-]*(?:[oO][fF]\\s+)?(?:[jJ][aA][nN](?:[uU][aA][rR][yY])?|[fF][eE][bB](?:[rR][uU][aA][rR][yY])?|[mM][aA][rR](?:[cC][hH])?|[aA][pP][rR](?:[iI][lL])?|[mM][aA][yY]|[jJ][uU][nN][eE]?|[jJ][uU][lL][yY]?|[aA][uU][gG](?:[uU][sS][tT])?|[sS][eE][pP](?:[tT](?:[eE][mM][bB][eE][rR])?)?|[oO][cC][tT](?:[oO][bB][eE][rR])?|[nN][oO][vV](?:[eE][mM][bB][eE][rR])?|[dD][eE][cC](?:[eE][mM][bB][eE][rR])?)[\\s,./-]*)(?:(?:19|20)\\d\\d)|(?:(?:19|20)\\d\\d)[\\s,./-]*(?:[jJ][aA][nN](?:[uU][aA][rR][yY])?|[fF][eE][bB](?:[rR][uU][aA][rR][yY])?|[mM][aA][rR](?:[cC][hH])?|[aA][pP][rR](?:[iI][lL])?|[mM][aA][yY]|[jJ][uU][nN][eE]?|[jJ][uU][lL][yY]?|[aA][uU][gG](?:[uU][sS][tT])?|[sS][eE][pP](?:[tT](?:[eE][mM][bB][eE][rR])?)?|[oO][cC][tT](?:[oO][bB][eE][rR])?|[nN][oO][vV](?:[eE][mM][bB][eE][rR])?|[dD][eE][cC](?:[eE][mM][bB][eE][rR])?)[\\s,./-]*(?:0?[1-9]|[12]\\d|3[01])(?:[sS][tT]|[nN][dD]|[rR][dD]|[tT][hH])?)?\\s*$", "type": "string", "description": "Keep only posts from this date on, and stop reading a profile's posts there. Pick a date or an age, or type one: a date (2026-01-31, 31/01/2026, Jan 31 2026; a UTC day), a date-time through the API (2026-01-31T18:00:00Z) or an age (7 days, 2w, 3 months, yesterday). Leave empty for no date limit." }, "includeRetweets": { "title": "Include reposts", "type": "boolean", "description": "Keep reposts among the latest posts. Turn off for the account's own posts only (they still count toward Latest posts per profile).", "default": true }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Residential proxies give the most reliable results and are the default. Example: Apify Proxy, RESIDENTIAL group.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }