# Twitter (X.com) Video Downloader (`scrapers-hub/twitter-x-video-downloader`) Actor Twitter/X Video Downloader lets you download publicly accessible videos from X (formerly Twitter) in high quality πŸŽ₯πŸ“₯ Perfect for offline viewing, content archiving, media management, and personal reference. - **URL**: https://apify.com/scrapers-hub/twitter-x-video-downloader.md - **Developed by:** [Scrapers Hub](https://apify.com/scrapers-hub) (community) - **Categories:** Videos, Social media - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.99 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. 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/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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) Video Downloader: The Professional Standard for Direct Media Extraction πŸŽ₯ Welcome to the comprehensive, 3000-word documentation for the **Twitter (X.com) Video Downloader**. In an increasingly fast-paced digital environment, capturing and archiving high-quality video content from platforms like X.com (formerly Twitter) has become a core requirement for journalists, data scientists, and digital marketers. The **Twitter (X.com) Video Downloader** was designed from the ground up to provide a robust, scalable, and highly reliable solution for direct media extraction. This guide explores every aspect of the **Twitter (X.com) Video Downloader**, including its technical architecture, configuration options, and real-world deployment strategies. Whether you're extracting a single viral clip or archiving thousands of educational videos, the **Twitter (X.com) Video Downloader** is your ultimate companion. 🌟 #### 🌟 Why the Twitter (X.com) Video Downloader is Essential The **Twitter (X.com) Video Downloader** is more than just a scraper; it is a professional-grade media gateway. It addresses the common pitfalls of web scrapingβ€”such as rate limiting, dynamic content loading, and IP-based blockingβ€”with a sophisticated, protocol-aware approach. ##### πŸ’Ž Direct and Uncompressed Downloads Unlike many "web-to-mp4" sites that re-encode and compress your media, the **Twitter (X.com) Video Downloader** focuses on extracting the direct, original source URL. This ensures that when you use the **Twitter (X.com) Video Downloader**, you are getting the highest quality version that the platform has to offer, without any additional loss of fidelity. ##### πŸ›‘οΈ Robust Connectivity with the Twitter (X.com) Video Downloader Twitter (X.com) uses aggressive anti-bot measures. The **Twitter (X.com) Video Downloader** is equipped to handle these through deep integration with Apify's Residential Proxy pool. By rotating identities for every attempt, the **Twitter (X.com) Video Downloader** stays below the radar of most automated blocking systems, ensuring a consistent and reliable experience for large-scale operations. #### πŸ“ Section 3: Deep Technical Breakdown of Input and Output πŸ› οΈ This section is dedicated to the technical configuration of the **Twitter (X.com) Video Downloader**. Success with the **Twitter (X.com) Video Downloader** depends on correctly defining your input parameters and understanding the structure of the resulting data. ##### πŸ“₯ Input Configuration for Twitter (X.com) Video Downloader The **Twitter (X.com) Video Downloader** uses a clean, array-based input schema. You can provide as many URLs as your project requires. | Parameter | Type | Required | Description | | :--- | :--- | :--- | :--- | | `startUrls` | Array | Yes | A list of Twitter status URLs to be processed by the **Twitter (X.com) Video Downloader**. | | `proxyConfiguration` | Object | No | Network settings for the **Twitter (X.com) Video Downloader**. We recommend Residential proxies for the best results. | ###### πŸ“„ Example Input JSON ```json { "startUrls": [ "https://x.com/TinaDebove/status/1967637722476212406" ], "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] } } ```` ##### πŸ“€ Output Specification for Twitter (X.com) Video Downloader The **Twitter (X.com) Video Downloader** pushes data in a streamlined JSON format. This simple structure is perfect for feeding directly into other automation tools or database systems. | Field | Type | Description | | :--- | :--- | :--- | | `sourceUrl` | String | The original or resolved Twitter URL processed by the **Twitter (X.com) Video Downloader**. | | `downloadUrl` | String | The direct media download link extracted by the **Twitter (X.com) Video Downloader**. | ###### πŸ“„ Example Output JSON ```json [ { "sourceUrl": "https://x.com/TinaDebove/status/1967637722476212406", "downloadUrl": "https://video.twimg.com/ext_tw_video/123/pu/vid/1280x720/xyz.mp4" } ] ``` #### πŸ“ˆ Major Use Cases for the Twitter (X.com) Video Downloader The **Twitter (X.com) Video Downloader** is a versatile tool used across many different industries. Here are four primary ways the **Twitter (X.com) Video Downloader** adds value: ##### πŸ•΅οΈ Use Case 1: Open Source Intelligence (OSINT) and Verification OSINT investigators use the **Twitter (X.com) Video Downloader** to secure copies of viral videos before they are removed by users or platform moderators. The **Twitter (X.com) Video Downloader**'s ability to extract the direct source URL is vital for forensic analysis, allowing investigators to check for tampering or specific metadata that might be present in the original stream. ##### πŸ“š Use Case 2: Digital Archiving and History Social media moves fast. The **Twitter (X.com) Video Downloader** allows archivists and historians to save digital artifacts of significant cultural importance. Whether it's a political speech or a piece of viral art, the **Twitter (X.com) Video Downloader** provides the scale needed to build a permanent record of the ephemeral web. ##### πŸ“Š Use Case 3: Competitive Research and Marketing Agencies use the **Twitter (X.com) Video Downloader** to build reference libraries of high-performing video content. By analyzing the videos downloaded with the **Twitter (X.com) Video Downloader**, creative teams can study lighting, editing, and pacing trends that drive engagement on the platform. ##### 🎨 Use Case 4: Content Creation and Curation Content creators use the **Twitter (X.com) Video Downloader** to gather high-res clips for compilation videos, reaction content, or news reporting. The **Twitter (X.com) Video Downloader** ensures that the source material is of the highest quality, making the final production look professional. #### 🧠 Optimization and Performance: Secrets of the Twitter (X.com) Video Downloader ⚑ To get the most out of the **Twitter (X.com) Video Downloader**, you should understand its internal optimization strategies. ##### πŸ”„ Dynamic Proxy Rotation The **Twitter (X.com) Video Downloader** doesn't just use a single IP. It integrates a fresh proxy URL for every attempt within its retry loop. This is a critical architectural feature of the **Twitter (X.com) Video Downloader** that ensures your job won't be derailed by a single bad connection or a blacklisted IP address. ##### πŸ›‘οΈ Robust Fault Tolerance The **Twitter (X.com) Video Downloader** is designed for high-availability. It implements a 3-attempt retry logic for every URL. If the platform returns a temporary error, the **Twitter (X.com) Video Downloader** pauses, rotates its identity, and tries again. This resilience is what makes the **Twitter (X.com) Video Downloader** a favorite for enterprise-level scraping. ##### 🚿 Description Link Resolution One unique feature of the **Twitter (X.com) Video Downloader** is its ability to parse tweet descriptions for `t.co` links. If a video is linked in the description rather than being native to the post, the **Twitter (X.com) Video Downloader** can often resolve and download that media as well, providing a more comprehensive scraping solution. #### πŸ› οΈ Installation and Configuration Walkthrough Getting started with the **Twitter (X.com) Video Downloader** is simple, whether you're a cloud user or a local developer. ##### ☁️ Deployment on Apify Cloud 1. **Select Actor:** Open the **Twitter (X.com) Video Downloader** in the store. 2. **Add URLs:** Enter your list into the `startUrls` field. 3. **Set Proxy:** For maximum reliability with the **Twitter (X.com) Video Downloader**, choose "Residential" proxies. 4. **Run:** Click Start. The **Twitter (X.com) Video Downloader** will begin its work instantly. ##### πŸ’» Local Development with Apify CLI 1. **CLI Install:** `npm install -g apify-cli`. 2. **Clone:** Download the **Twitter (X.com) Video Downloader** source. 3. **Initialize:** Run `apify login`. 4. **Execute:** Run `apify run` to start the **Twitter (X.com) Video Downloader** locally. #### 🧐 Frequently Asked Questions (FAQ) ##### ❓ Is the Twitter (X.com) Video Downloader compatible with mobile links? Yes! The **Twitter (X.com) Video Downloader** can handle `mobile.twitter.com` or `x.com` links interchangeably. ##### ❓ Can the Twitter (X.com) Video Downloader download from private accounts? No. The **Twitter (X.com) Video Downloader** can only extract media from publicly accessible tweets. ##### ❓ What is the best proxy group for the Twitter (X.com) Video Downloader? We highly recommend the "RESIDENTIAL" group for the **Twitter (X.com) Video Downloader** to ensure the highest success rate and bypass platform blocking. ##### ❓ How do I handle batch errors in the Twitter (X.com) Video Downloader? The **Twitter (X.com) Video Downloader** logs all errors clearly. If a URL fails after three attempts, the **Twitter (X.com) Video Downloader** will move on to the next item, ensuring your entire job isn't stopped by one problematic link. ##### ❓ Does the Twitter (X.com) Video Downloader support authenticated sessions? This version of the **Twitter (X.com) Video Downloader** is designed for public extraction. For authenticated sessions, custom configuration is required. #### πŸ›‘οΈ Ethical Scraping Guidelines for the Twitter (X.com) Video Downloader We encourage all users of the **Twitter (X.com) Video Downloader** to practice responsible scraping: - **Pacing:** Allow the **Twitter (X.com) Video Downloader** to process at a steady pace; don't try to force hundreds of simultaneous requests. - **Privacy:** Use the **Twitter (X.com) Video Downloader** only for public content and respect the original creator's intent. - **Lawful Use:** Ensure your use of the **Twitter (X.com) Video Downloader** complies with your jurisdiction's copyright and data privacy laws. #### πŸ”§ Troubleshooting the Twitter (X.com) Video Downloader ###### ❌ Error: "Unable to connect to proxy" If the **Twitter (X.com) Video Downloader** reports this, it means the residential IP was rejected. The **Twitter (X.com) Video Downloader** will automatically retry with a fresh IP from the pool. ###### ❌ Error: "No start URLs provided" Check your input JSON. The **Twitter (X.com) Video Downloader** requires the `startUrls` field to be populated with at least one valid link. ###### ❌ Issue: The download link is expired Twitter download links are temporary. You should use the **Twitter (X.com) Video Downloader** to gather and then immediately download the media for archival. #### πŸ“ Final Thoughts on the Twitter (X.com) Video Downloader The **Twitter (X.com) Video Downloader** is the premier choice for professional media extraction from X.com. By focusing on quality, reliability, and ease of use, the **Twitter (X.com) Video Downloader** empowers users to capture the digital world as it happens. Whether you are a small archivist or a large-scale data agency, the **Twitter (X.com) Video Downloader** is built for you. Thank you for choosing the **Twitter (X.com) Video Downloader**. We are committed to continuing the development of the **Twitter (X.com) Video Downloader** to stay ahead of platform changes. Happy downloading! πŸš€πŸŽ₯✨ *** ###### πŸ“Š Feature Matrix: Twitter (X.com) Video Downloader vs. Competitors | Feature | **Twitter (X.com) Video Downloader** | Web Converters | Basic Scripts | | :--- | :--- | :--- | :--- | | **Source Extraction** | Direct (Original) | Re-encoded (Lower Quality) | Variable | | **Proxy Rotation** | Automatic Residential | None | Manual Only | | **Error Handling** | Advanced Retry Logic | None | Basic | | **Batch Support** | High-volume | Single URL | Limited | | **Output Format** | Clean JSON | File only | Raw data | *** #### πŸ› οΈ Technical Deep Dive: Inside the Twitter (X.com) Video Downloader For the technical users, here is what makes the **Twitter (X.com) Video Downloader** tick: - **Runtime Environment:** Python 3.14.3 - **Scraping Engine:** Optimized `yt-dlp` integration. - **Async Architecture:** Non-blocking IO for high-throughput processing in the **Twitter (X.com) Video Downloader**. - **Proxy Tunneling:** Custom proxy rotation logic for every request attempt. - **Resilience:** Built-in exponential backoff for platform errors. The **Twitter (X.com) Video Downloader** is a masterpiece of efficient engineering, designed to minimize compute costs while maximizing data reliability. When you run the **Twitter (X.com) Video Downloader**, you are running one of the most optimized actors on the Apify platform. ##### πŸ”’ Data Security and Sovereignty The **Twitter (X.com) Video Downloader** operates with total respect for your data privacy. Your inputs and the extracted links are processed securely within the Apify environment. The **Twitter (X.com) Video Downloader** does not store your data beyond the scope of your specific run. #### 🌟 Conclusion In summary, the **Twitter (X.com) Video Downloader** is your ultimate partner for social media video extraction. With its powerful features, intelligent networking, and professional documentation, the **Twitter (X.com) Video Downloader** stands alone in its category. Don't settle for unreliable tools. Use the **Twitter (X.com) Video Downloader** and see the difference that high-end engineering makes for your media projects. We are proud to bring you the **Twitter (X.com) Video Downloader**, and we are here to support your scraping success every step of the way! πŸš€πŸŽ₯πŸ“‚ # Actor input Schema ## `startUrls` (type: `array`): List of Twitter/X status URLs to scrape. ## Actor input object example ```json { "startUrls": [ "https://x.com/TinaDebove/status/1967637722476212406" ] } ``` # 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://x.com/TinaDebove/status/1967637722476212406" ] }; // Run the Actor and wait for it to finish const run = await client.actor("scrapers-hub/twitter-x-video-downloader").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://x.com/TinaDebove/status/1967637722476212406"] } # Run the Actor and wait for it to finish run = client.actor("scrapers-hub/twitter-x-video-downloader").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://x.com/TinaDebove/status/1967637722476212406" ] }' | apify call scrapers-hub/twitter-x-video-downloader --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=scrapers-hub/twitter-x-video-downloader", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Twitter (X.com) Video Downloader", "description": "Twitter/X Video Downloader lets you download publicly accessible videos from X (formerly Twitter) in high quality πŸŽ₯πŸ“₯ Perfect for offline viewing, content archiving, media management, and personal reference.", "version": "0.1", "x-build-id": "TAtVW4ZDrFAhZ1xel" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapers-hub~twitter-x-video-downloader/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapers-hub-twitter-x-video-downloader", "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/scrapers-hub~twitter-x-video-downloader/runs": { "post": { "operationId": "runs-sync-scrapers-hub-twitter-x-video-downloader", "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/scrapers-hub~twitter-x-video-downloader/run-sync": { "post": { "operationId": "run-sync-scrapers-hub-twitter-x-video-downloader", "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": [ "startUrls" ], "properties": { "startUrls": { "title": "Start URLs", "type": "array", "description": "List of Twitter/X status URLs to scrape.", "items": { "type": "string" } } } }, "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 } } } } } } } } } } ```