# X.com Twitter User Tweets Scraper (`xtdata/twitter-x-user-tweets-scraper`) Actor Scrape tweets for target user profiles or handles data from Twitter (now X). Ideal for researchers, analysts, and social media tracking. - **URL**: https://apify.com/xtdata/twitter-x-user-tweets-scraper.md - **Developed by:** [xtdata](https://apify.com/xtdata) (community) - **Categories:** Automation, News, Social media - **Stats:** 226 total users, 37 monthly users, 98.9% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing from $0.50 / 1,000 price for each tweet. cheaper when upgrade plan.s This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Twitter X.com User Tweets Scraper - Fast and Efficient Tweet Extraction This Actor provides a powerful and specific way to scrape data from Twitter (now X). It allows you to reliably extract tweets for target user profiles or handles, making it ideal for researchers, analysts, and social media tracking. ### Key Features * **Focused Input Methods:** Get straightforward, exact data from users: * **Start URLs:** Provide direct Twitter (X) Profile URLs and get their tweets. * **Twitter Handles:** Simply list the target handles (usernames) you want to extract tweets from. * **Targeted Output:** * **Maximum Items:** Control the maximum number of tweets retrieved for each user. * **Custom Map Function:** Transform and shape the output data using a custom JavaScript function before it is saved (for data shaping, *not* filtering). * **Built-in Concurrency & Pagination:** * Efficiently crawls and paginates through a user's timeline timeline for quick and stable extraction, utilizing Apify actors' concurrent network architecture. * **Cost-Effective & Event-Driven:** * Charge for Event. ### Use Cases * **Market & Sentiment Research:** Track recent statements and communications from specific brand or public figure profiles. * **Academic Research:** Gather user-centric dialogue data for social media and political science studies. * **Competitive Analysis:** Monitor targeted competitors' recent Twitter engagement or update feeds. * **Data Archival:** Regularly save out the timeline for designated profiles for record keeping. ### Quick Start Examples Here are some example input configurations to get you started quickly: **Fetching Tweets from Multiple Specific Profiles (e.g., NASA and Elon Musk):** ```json { "startUrls": [ "https://twitter.com/apify", "https://twitter.com/elonmusk" ], "twitterHandles": [ "taylorswift13", "nasa" ], "maxItems": 50, "customMapFunction": "(object) => { return {...object} }" } ```` ### Explanation of Key Input Fields - `startUrls`: An array of explicit profile URLs you want to scrape (e.g. `https://twitter.com/elonmusk`). Only Profile URLs are supported by this specific Actor approach. - `twitterHandles`: An array of raw usernames (handles) for Twitter targets if you prefer not to use full URLs. - `maxItems`: An integer limiting the maximum number of paginated output items for each target. - `customMapFunction`: Execute raw javascript logic to mutate or adjust the parsed `tweet` Object right before it is pushed to the Actor storage. Caution: improper functions may break output data shape. ### Usage Guidelines (Important!) - **Data Limits:** Ensure you understand the event limit configuration of the actor as it runs in `pay-per-result` (or similar) mode. - **Respect Twitter's Terms of Service**: Always use this tool ethically and responsibly. - **Concurrent Batches**: If passing many URLs or Handles, the Actor natively parallelizes requests. Make sure memory settings can accommodate heavy payload iterations. ### Ethical Use and Data Practices Our 'actor' operates without logging in to X.com. This means it does not implicitly accept any Terms of Service (ToS) that require a login, as we only process data that is publicly displayed and accessible to everyone without authentication. We are fully committed to the principle of privacy by design and by default. All data collected explicitly excludes sensitive personal information or non-public data. Furthermore, our actor runs on Apify, an EU-based company, which means our operations are designed to be compliant with relevant EU data protection regulations, including GDPR, where applicable. You can find more information about the legality of web scraping on Apify's blog: https://blog.apify.com/is-web-scraping-legal/ We have implemented robust technical measures to ensure the actor operates gently and does not impose an undue burden on X.com's servers. Our sole purpose is to facilitate responsible research and public data analysis, and we strictly prohibit any use that could cause harm to any party or the platform itself. #### Output Example ```json [ { "id": "2029985250512920743", "url": "https://x.com/OpenAI/status/2029985250512920743", "twitterUrl": "https://twitter.com/OpenAI/status/2029985250512920743", "author": { "advertiser_account_service_levels": [ "dso", "dso", "dso", "dso", "dso", "analytics" ], "advertiser_account_type": "promotable_user", "analytics_type": "enabled", "blocked_by": false, "blocking": false, "can_dm": false, "can_media_tag": true, "created_at": "Sun Dec 06 22:51:08 +0000 2015", "description": "OpenAI’s mission is to ensure that artificial general intelligence benefits all of humanity. We’re hiring: https://t.co/dJGr6LgzPA", "entities": { "description": { "hashtags": [], "symbols": [], "urls": [ { "display_url": "openai.com/jobs", "expanded_url": "http://openai.com/jobs", "indices": [ 107, 130 ], "url": "https://t.co/dJGr6LgzPA" } ], "user_mentions": [] }, "url": { "urls": [ { "display_url": "openai.com", "expanded_url": "https://openai.com", "indices": [ 0, 23 ], "url": "https://t.co/3bPlZZkvdL" } ] } }, "fast_followers_count": 0, "favourites_count": 1756, "follow_request_sent": false, "followed_by": false, "followers_count": 4671709, "following": false, "friends_count": 4, "geo_enabled": false, "has_custom_timelines": false, "has_extended_profile": false, "id_str": "4398626122", "is_translator": false, "location": "", "media_count": 522, "muting": false, "name": "OpenAI", "normal_followers_count": 4671709, "notifications": false, "pinned_tweet_ids_str": [ "2029620619743219811" ], "profile_background_color": "C0DEED", "profile_banner_url": "https://pbs.twimg.com/profile_banners/4398626122/1770318871", "profile_image_url_https": "https://pbs.twimg.com/profile_images/1885410181409820672/ztsaR0JW_normal.jpg", "profile_interstitial_type": "", "profile_link_color": "1DA1F2", "protected": false, "screen_name": "OpenAI", "statuses_count": 1712, "translator_type_enum": "None", "url": "https://t.co/3bPlZZkvdL", "verified": false, "verified_type": "Business", "want_retweets": false, "withheld_in_countries": [] }, "full_text": "Codex Security—our application security agent—is now in research preview.\n\nhttps://t.co/JG2uwGUJFv", "favorite_count": 2522, "retweet_count": 245, "reply_count": 310, "quote_count": 137, "bookmark_count": 745, "bookmarked": false, "conversation_id_str": "2029985250512920743", "created_at": "Fri Mar 06 18:19:33 +0000 2026", "display_text_range": [ 0, 98 ], "entities": { "hashtags": [], "symbols": [], "timestamps": [], "urls": [ { "display_url": "openai.com/index/codex-se…", "expanded_url": "https://openai.com/index/codex-security-now-in-research-preview/", "indices": [ 75, 98 ], "url": "https://t.co/JG2uwGUJFv" } ], "user_mentions": [] }, "favorited": false, "is_quote_status": false, "lang": "en", "possibly_sensitive": false, "possibly_sensitive_editable": true, "retweeted": false, "user_id_str": "4398626122" } ] ``` ### Troubleshooting If you encounter issues like early termination, check if your Apify workspace event allocation limits were breached. Be sure that `startUrls` specifically links to direct user profiles rather than general search pages, as this Actor is specialized for user timelines. ### Get Started Start scraping Twitter data today! This Actor provides a powerful, flexible, and cost-effective solution for targeted user data extraction needs. #### **1. TikTok Actors** | | | | |-------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------| | [⚡ Fast TikTok API (No WM)](https://apify.com/novi/fast-tiktok-api?fpr=7hce1m) | [👤 Tiktok User Profile API](https://apify.com/novi/tiktok-user-info-api?fpr=7hce1m) | [🔍 Advanced Search TikTok](https://apify.com/novi/advanced-search-tiktok-api?fpr=7hce1m) | | [🔎 TikTok Search Scraper](https://apify.com/novi/tiktok-search-api?fpr=7hce1m) | [📈 Tiktok Trend API](https://apify.com/novi/tiktok-trend-api?fpr=7hce1m) | [💬 TikTok Comment API](https://apify.com/novi/tiktok-comment-api?fpr=7hce1m) | | [🎞️ TikTok Profile Videos API](https://apify.com/novi/tiktok-user-api?fpr=7hce1m) | [#️⃣ TikTok Hashtag API](https://apify.com/novi/tiktok-hashtag-api?fpr=7hce1m) | [🎵 TikTok Sound Music API](https://apify.com/novi/tiktok-sound-api?fpr=7hce1m) | | [👥 TikTok Followers API](https://apify.com/novi/tiktok-followers-api?fpr=7hce1m) | [🔢 Multiple Hashtags Scraper](https://apify.com/novi/multiple-tiktok-hashtag-scraper?fpr=7hce1m) | [🏆 TikTok Scraper Ultimate](https://apify.com/novi/tiktok-scraper-ultimate?fpr=7hce1m) | | [🎶 TikTok Music Trend API](https://apify.com/novi/tiktok-music-trend-api?fpr=7hce1m) | [🛍️ TikTok Shop Scraper](https://apify.com/novi/tiktok-shop-scraper?fpr=7hce1m) | [💰 TikTok Scraper (Pay per video)](https://apify.com/novi/fast-tiktok-scraper?fpr=7hce1m) | | [📄 Fast TikTok API (Simple)](https://www.google.com/search?q=https://apify.com/novi/fast-tiktok-api-with-simple-result?fpr=7hce1m) | [🆔 TikTok User Profile Scraper](https://apify.com/xtdata/tiktok-user-information-scraper?fpr=7hce1m) | [📍 TikTok Location API](https://apify.com/novi/tiktok-location-api?fpr=7hce1m) | | [🤖 TikTok AI Video Scraper](https://apify.com/novi/tiktok-ai-video-scraper?fpr=7hce1m) | [🗯️ TikTok Comment (Novi)](https://apify.com/novi/tiktok-comment-scraper?fpr=7hce1m) | [🏷️ TikTok Scraper (Fixed price)](https://apify.com/xtdata/tiktok-scraper?fpr=7hce1m) | | [🗣️ TikTok Comment + Replies](https://apify.com/xtdata/tiktok-comment-scraper?fpr=7hce1m) | | | #### **2. X.com (Twitter) Actors** | | | | |---------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------| | [🐦 X.com Twitter API Scraper](https://apify.com/xtdata/twitter-x-scraper?fpr=7hce1m) | [🐦 X.com Twitter User Tweets Scraper](https://apify.com/xtdata/twitter-x-user-tweets-scraper?fpr=7hce1m) | [🐦 X.com Twitter User Tweets Scraper](https://apify.com/xtdata/twitter-x-user-search-scraper?fpr=7hce1m) | #### **3. YouTube Actors** | | | | |---------------------------------------------------------------------------------------|--|--| | [📜 YouTube Transcript API](https://apify.com/novi/youtube-transcript-api?fpr=7hce1m) | | | # Actor input Schema ## `startUrls` (type: `array`): Twitter (X) Profile URLs. Paste the URLs and get the results immediately. Only Profile URLs are supported. ## `twitterHandles` (type: `array`): Twitter handles (username) that you want to search on Twitter (X) ## `maxItems` (type: `integer`): Maximum number of tweets for each user that you want as output. ## `customMapFunction` (type: `string`): Function that takes each of the objects as argument and returns data that will be mapped by the function itself. This function is not intended for filtering, please don't use it for filtering purposes or you will get banned automatically. ## Actor input object example ```json { "startUrls": [ "https://twitter.com/apify" ], "twitterHandles": [ "elonmusk" ], "maxItems": 20, "customMapFunction": "(object) => { return {...object} }" } ``` # Actor output Schema ## `results` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "startUrls": [ "https://twitter.com/apify" ], "twitterHandles": [ "elonmusk" ], "maxItems": 20, "customMapFunction": (object) => { return {...object} } }; // Run the Actor and wait for it to finish const run = await client.actor("xtdata/twitter-x-user-tweets-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "startUrls": ["https://twitter.com/apify"], "twitterHandles": ["elonmusk"], "maxItems": 20, "customMapFunction": "(object) => { return {...object} }", } # Run the Actor and wait for it to finish run = client.actor("xtdata/twitter-x-user-tweets-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "startUrls": [ "https://twitter.com/apify" ], "twitterHandles": [ "elonmusk" ], "maxItems": 20, "customMapFunction": "(object) => { return {...object} }" }' | apify call xtdata/twitter-x-user-tweets-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=xtdata/twitter-x-user-tweets-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "X.com Twitter User Tweets Scraper", "description": "Scrape tweets for target user profiles or handles data from Twitter (now X). Ideal for researchers, analysts, and social media tracking.", "version": "0.0", "x-build-id": "JlovlQ6VwuafqEwZg" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/xtdata~twitter-x-user-tweets-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-xtdata-twitter-x-user-tweets-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/xtdata~twitter-x-user-tweets-scraper/runs": { "post": { "operationId": "runs-sync-xtdata-twitter-x-user-tweets-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/xtdata~twitter-x-user-tweets-scraper/run-sync": { "post": { "operationId": "run-sync-xtdata-twitter-x-user-tweets-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": "Twitter (X) Profile URLs. Paste the URLs and get the results immediately. Only Profile URLs are supported.", "items": { "type": "string" } }, "twitterHandles": { "title": "Twitter handles (username).", "type": "array", "description": "Twitter handles (username) that you want to search on Twitter (X)", "items": { "type": "string" } }, "maxItems": { "title": "Maximum number of tweets each user on output", "type": "integer", "description": "Maximum number of tweets for each user that you want as output." }, "customMapFunction": { "title": "Custom map function", "type": "string", "description": "Function that takes each of the objects as argument and returns data that will be mapped by the function itself. This function is not intended for filtering, please don't use it for filtering purposes or you will get banned automatically." } } }, "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 } } } } } } } } } } ```