Twitter/X Scraper - Tweets, Profiles & Trends
Pricing
from $10.00 / 1,000 tweet scrapeds
Scrape Twitter/X: tweets, user profiles, followers, hashtags, and trending topics.
Pricing
from $10.00 / 1,000 tweet scrapeds
Rating
5.0
(4)
Developer
viralanalyzer
Maintained by CommunityActor stats
0
Bookmarked
121
Total users
4
Monthly active users
an hour ago
Last modified
Categories
Share
You can access the Twitter/X Scraper - Tweets, Profiles & Trends programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in API & Integrations in Apify Console.
{ "openapi": "3.0.1", "info": { "version": "1.3", "x-build-id": "Uv01y7FXASQ5Oh2Bw" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/viralanalyzer~twitter-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-viralanalyzer-twitter-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/viralanalyzer~twitter-scraper/runs": { "post": { "operationId": "runs-sync-viralanalyzer-twitter-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/viralanalyzer~twitter-scraper/run-sync": { "post": { "operationId": "run-sync-viralanalyzer-twitter-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": { "profiles": { "title": "Profiles", "type": "array", "description": "List of Twitter/X usernames to scrape (e.g. ['nasa', 'elonmusk']), with or without @. An entry that is not a valid handle (1-15 letters, digits or _) or a profile URL is ignored and named in the log. With no profile, search query or tweet URL, the run returns a diagnostic item instead of scraping a default account.", "items": { "type": "string" } }, "tweetUrls": { "title": "Tweet URLs (replies mode)", "type": "array", "description": "Read the REPLIES of these posts, one item per reply, each with the author and the badge. Accepts a full URL (https://x.com/nasa/status/1234567890) or a bare post id. When this is set, the actor ignores profiles/searchQuery and runs in replies mode. Without an X API token the actor tries the anonymous path and, when X refuses it, returns a diagnostic item without charging. With a token, replies come from recent search (conversation_id operator), which only covers the last 7 days.", "items": { "type": "string" } }, "conversationIds": { "title": "Conversation IDs (replies mode)", "type": "array", "description": "Same as Tweet URLs, but taking the conversation id directly. Use either one.", "items": { "type": "string" } }, "searchQuery": { "title": "Search Query", "type": "string", "description": "Search term across Twitter/X (alternative to profiles). Leave empty to use profiles list." }, "maxTweets": { "title": "Max Tweets", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum number of items to return per profile, search or conversation. Tweets are ordered newest-first before the cut. Note on the official X API: its timeline endpoint reads a minimum of 5 posts per request and search a minimum of 10, so asking for 1 still bills you for 5 (or 10) post reads at $0.005 each.", "default": 20 }, "maxResults": { "title": "Max Results (alias of Max Tweets)", "minimum": 1, "maximum": 100, "type": "integer", "description": "Cross-actor alias for maxTweets. When set, it overrides maxTweets." }, "seeds": { "title": "Seeds (unified input)", "type": "array", "description": "Cross-actor unified seed list. Optional. Combined with 'seedType' to choose how each entry is interpreted. If omitted/empty, the actor uses 'profiles' / 'searchQuery' exactly as before. seedType=handle → usernames (without @); seedType=url → twitter.com/x.com profile or tweet URLs (the username is extracted); seedType=keyword → search terms (requires the X API Bearer Token, like searchQuery).", "items": { "type": "string" } }, "seedType": { "title": "Seed Type", "enum": [ "handle", "url", "keyword" ], "type": "string", "description": "How to interpret the 'seeds' entries. Only applies when 'seeds' is non-empty. 'handle' = Twitter/X usernames; 'url' = profile/tweet URLs (username extracted); 'keyword' = search terms (requires the X API Bearer Token).", "default": "handle" }, "includeReplies": { "title": "Include Replies", "type": "boolean", "description": "Include reply tweets in results", "default": false }, "includeRetweets": { "title": "Include Retweets", "type": "boolean", "description": "Include retweets in results", "default": false }, "includePinned": { "title": "Include the pinned tweet", "type": "boolean", "description": "A profile's pinned tweet can be years old. By default it is excluded, so \"Max Tweets: 1\" returns the most RECENT tweet instead of the pinned one. Set true to keep it — it is then ordered by date like any other tweet and carries is_pinned: true.", "default": false }, "dateFrom": { "title": "Date From", "type": "string", "description": "Lower bound, inclusive. YYYY-MM-DD (00:00:00.000Z of that day, UTC) or a full ISO-8601 timestamp. With an X API token the bound is sent to the API (start_time), so you do not pay for reads the filter would discard; the anonymous strategies have no date parameter and are filtered in memory. A tweet the filter drops is never pushed and never charged. An unreadable value stops the run with a diagnostic and no charge." }, "dateTo": { "title": "Date To", "type": "string", "description": "Upper bound, inclusive. YYYY-MM-DD (23:59:59.999Z of that day, UTC) or a full ISO-8601 timestamp. Sent to the API as end_time when a token is provided. Same billing rule as Date From." }, "twitterBearerToken": { "title": "X API Bearer Token (recommended — most reliable)", "type": "string", "description": "Official X (Twitter) API v2 Bearer Token. When provided, the actor calls the official API first — the only reliable method, since X blocks anonymous (guest) access to timelines. Get yours at https://developer.x.com (your own X API plan/quota applies)." }, "brightDataApiToken": { "title": "Bright Data API token (optional unblocking fallback)", "type": "string", "description": "Optional. Used ONLY when x.com refuses the ordinary request: the actor then fetches the same page through Bright Data Web Unlocker, which is billed per REQUEST (not per record). Leave empty to skip the paid fallback entirely — the actor still tries the free paths and returns a diagnostic if they are blocked." }, "brightDataZone": { "title": "Bright Data zone", "type": "string", "description": "Unlocker zone name for the token above. Defaults to the zone configured on the actor." }, "maxUnlockerRequests": { "title": "Max unblocking requests per run", "minimum": 0, "maximum": 10, "type": "integer", "description": "Hard cap on the paid fallback, so a blocked target cannot run up a bill. Default 3, maximum 10.", "default": 3 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy used by the anonymous scraping strategies. Default = Apify datacenter proxy (low cost). If runs return only a diagnostic item, enable RESIDENTIAL proxies here — note that residential traffic is billed as platform usage.", "default": { "useApifyProxy": true } }, "normalizeOutput": { "title": "Add normalized output block", "type": "boolean", "description": "When true, each item additionally carries a cross-platform '_normalized' block { platform, url, author, text, views, likes, comments, shares, publishedAtISO, lang, hashtags[], engagementVelocity } alongside the existing raw fields. Default false — output is byte-for-byte identical to before.", "default": false } } }, "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 } } }, "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 } } } } } } } } }}OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.
OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.
By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.
You can download the OpenAPI definitions for Twitter/X Scraper - Tweets, Profiles & Trends from the options below:
If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.
You can also check out our other API clients: