{ "openapi": "3.0.1", "info": { "title": "Twitter (X) Profile & Tweets Scraper", "description": "Scrape Twitter (X) profiles and individual tweets — no login, no API key. Get clean, structured data: full text, likes, retweets, replies, views, author profile, follower counts, media and entities. Mix profile URLs and tweet links in one run. Export to JSON, CSV, Excel or API", "version": "0.0", "x-build-id": "mLlvrqc2TewWpsRnT" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/memo23~twitter-x-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-memo23-twitter-x-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/memo23~twitter-x-scraper/runs": { "post": { "operationId": "runs-sync-memo23-twitter-x-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/memo23~twitter-x-scraper/run-sync": { "post": { "operationId": "run-sync-memo23-twitter-x-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": { "startUrls": { "title": "Start URLs", "type": "array", "description": "X profile URLs or bare handles (e.g. `https://x.com/nasa` or `nasa`), and/or individual tweet URLs (e.g. `https://x.com/Twitter/status/20`). You can mix profiles and tweets in one run. Optional if you supply Tweet IDs instead. Keyword search and follower lists are not supported (they need a logged-in account).", "items": { "type": "string" } }, "tweetIds": { "title": "Tweet IDs", "type": "array", "description": "Bare numeric tweet ids to fetch, e.g. 20. Use this instead of building https://x.com/i/status/ URLs by hand. Combined with Start URLs when both are given.", "items": { "type": "string" } }, "maxConcurrency": { "title": "Max Concurrency", "type": "integer", "description": "Maximum number of pages that can be processed at the same time.", "default": 10 }, "minConcurrency": { "title": "Min Concurrency", "type": "integer", "description": "Minimum number of pages that will be processed at the same time.", "default": 1 }, "maxRequestRetries": { "title": "Max Request Retries", "type": "integer", "description": "Number of times the crawler will retry a failed request before giving up. Each retry is billed for the full time it waits, so this is capped at 5.", "default": 5 }, "maxItems": { "title": "Max items", "type": "integer", "description": "Maximum number of tweets/profiles to scrape across all start URLs.", "default": 1000 }, "onlyTweetsAfter": { "title": "Only tweets after", "type": "string", "description": "Keep only tweets posted on or after this date. Accepts YYYY-MM-DD or a full ISO timestamp. Because a profile timeline is newest-first, the scraper stops paging as soon as it walks past this date." }, "onlyTweetsBefore": { "title": "Only tweets before", "type": "string", "description": "Keep only tweets posted before this date. Accepts YYYY-MM-DD or a full ISO timestamp." }, "includeRetweets": { "title": "Include retweets", "type": "boolean", "description": "Keep retweets in the output. Retweets carry the original tweet expanded under retweetedTweet. Turn off for original posts only.", "default": true }, "includeReplies": { "title": "Include replies", "type": "boolean", "description": "Keep replies in the output. Replies carry inReplyToId, inReplyToUserId and inReplyToUsername so you can thread them.", "default": true }, "includeRawData": { "title": "Include raw data", "type": "boolean", "description": "When enabled, each record also includes the full raw X GraphQL object under `otherData`. Off by default for clean, compact output.", "default": false }, "proxy": { "title": "Proxy configuration", "type": "object", "description": "Proxy servers used to hide the scraper's origin. Leave as Apify Proxy (automatic) unless you have a reason to change it — pinning a specific group such as RESIDENTIAL means the run is rejected outright if that group is unavailable to the account paying for it. You can still select RESIDENTIAL here if you want it.", "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 } } } } } } } } } }