{ "openapi": "3.0.1", "info": { "title": "Twitter / X Scraper | No API Key | Pay Per Tweet", "description": "Scrape public tweets from X (Twitter) by keyword, hashtag or username without a paid API key. Returns text, likes, retweets, views, date and media URLs. MCP ready. Pay per tweet, first 10 free.", "version": "0.1", "x-build-id": "jYpjNwbm6D1QYoiaB" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/themineworks~twitter-x-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-themineworks-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/themineworks~twitter-x-scraper/runs": { "post": { "operationId": "runs-sync-themineworks-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/themineworks~twitter-x-scraper/run-sync": { "post": { "operationId": "run-sync-themineworks-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": { "handles": { "title": "X accounts (handles)", "type": "array", "description": "Start here. X usernames to pull the latest posts from, with or without the @. Works with no login and no API key: each account returns the 20 to 24 posts X shows on its timeline. Example: [\"NASA\", \"AnthropicAI\"]", "items": { "type": "string" } }, "maxTweets": { "title": "Max tweets per source", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum posts per account or search term, up to 100. An account timeline gives about 20 to 24 posts without login, so values above 25 matter only for logged in search.", "default": 20 }, "searchTerms": { "title": "Search terms (needs your X login)", "type": "array", "description": "Keywords or hashtags to search. X only allows keyword search for a logged in session, so this works only together with sessionCookies or authToken below. Without them each term returns one no_results row and nothing is charged. Example: [\"#AI\", \"Anthropic Claude\"]", "items": { "type": "string" } }, "sessionCookies": { "title": "Session cookies (optional)", "type": "array", "description": "Cookie objects from a logged-in X session. Export from browser DevTools > Application > Cookies > twitter.com. Paste as JSON array, e.g. [{\"name\": \"auth_token\", \"value\": \"1a2b3c4d5e6f7g8h9i0j\", \"domain\": \".twitter.com\", \"path\": \"/\"}]. If provided, unlocks login-gated content." }, "authToken": { "title": "Auth token (optional, alternative to sessionCookies)", "type": "string", "description": "Value of the auth_token cookie from a logged-in X session. Shorter alternative to pasting the full cookie array." }, "searchFilter": { "title": "Tweet type filter", "enum": [ "top", "latest" ], "type": "string", "description": "Filter search results to top tweets or latest", "default": "top" }, "useBrowserFallback": { "title": "Try browser fallback for unauthenticated search", "type": "boolean", "description": "Off by default. X requires a real login for keyword search, so without sessionCookies a search returns nothing. Enabling this launches Chromium to DOM-scrape the search page instead: it is roughly 5x more expensive per run and usually still returns nothing, because X blocks the rendered page too. Handles never need this.", "default": false }, "monitorMode": { "title": "Monitor mode (only new posts)", "type": "boolean", "description": "Run on a schedule and deliver ONLY posts not seen in a previous run. You are charged per new post, not for the whole feed each time. Ideal for daily monitoring. Requires the same input across runs.", "default": false }, "proxyConfig": { "title": "Proxy configuration (search fallback only)", "type": "object", "description": "Only used by the unauthenticated-search browser fallback. Handles and authenticated search go over plain HTTP with no proxy.", "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 } } } } } } } } } }