{ "openapi": "3.0.1", "info": { "title": "X (Twitter) Tweet Details Scraper — URL to Full Record", "description": "Paste tweet addresses or ids; get each tweet's current likes, replies, reposts and quotes, its text, media, links and flags, and its author's full account record (followers, bio, website, verification). Reads tweets of any age. No login, no API key.", "version": "0.1", "x-build-id": "y63PooVoZcbijQDBH" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/foxlabs~x-tweet-details-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-foxlabs-x-tweet-details-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-tweet-details-scraper/runs": { "post": { "operationId": "runs-sync-foxlabs-x-tweet-details-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-tweet-details-scraper/run-sync": { "post": { "operationId": "run-sync-foxlabs-x-tweet-details-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": [ "tweets" ], "properties": { "tweets": { "title": "Tweet addresses or ids", "type": "array", "description": "One per line: a tweet address (https://x.com/NASA/status/2111180963661435219, twitter.com/... and the /photo/1 suffix work too) or its numeric id. Duplicate lines are read once and charged once.", "default": [ "https://x.com/jack/status/20" ], "items": { "type": "string" } }, "enrichAuthor": { "title": "Read the author's page for the full record", "type": "boolean", "description": "X states only the like count and the reply count on a single tweet, and only eight fields about its author. With this on, each author's newest page is read once per run, which adds the repost and quote counts for every tweet on that page and the author's full account record (followers, following, posts, bio, location, website, verification, account age) to every row. It costs one read per author, not per tweet, and those reads are not charged to you.", "default": true }, "includeAuthorRows": { "title": "Also deliver one row per author", "type": "boolean", "description": "One extra row for each author whose page was read: the account itself, with the same fields as the X Profile Scraper's rows. Charged as an author row.", "default": false }, "postedWithinDays": { "title": "Only tweets from the last N days", "minimum": 0, "maximum": 7300, "type": "integer", "description": "0 means no limit. A tweet older than this is read but not delivered and not charged.", "default": 0 }, "minEngagement": { "title": "Minimum engagement", "minimum": 0, "type": "integer", "description": "Likes + reposts + replies + quotes, as far as the source states them. A tweet under this is not delivered and not charged.", "default": 0 }, "maxTweets": { "title": "Maximum rows in the whole run", "minimum": 0, "type": "integer", "description": "A cost cap. 0 means every line in the list is read.", "default": 0 }, "concurrency": { "title": "Tweets read at the same time", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many tweets are read side by side. Measured 2026-10-18: 25 reads in 12 seconds with no refusal, so the default is comfortable.", "default": 8 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Left as it is, the Actor uses Apify Proxy datacenter addresses — everything it reads is asked for by numeric id, and X answers those from datacenter addresses, so no residential proxy is needed.", "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 } } } } } } } } } }