# Twitter Video Downloader (`solid-scraper/twitter-video-downloader`) Actor 🚀 Download Twitter (X) videos fast with Twitter Video Downloader! Save in seconds, keep quality, and watch offline anytime 📥📺 Perfect for creators, marketers, and fans—simple, secure, and efficient. Try it now! - **URL**: https://apify.com/solid-scraper/twitter-video-downloader.md - **Developed by:** [SolidScraper](https://apify.com/solid-scraper) (community) - **Categories:** Videos, Social media, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $2.99 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. 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 Video Downloader 🎬 **Twitter Video Downloader** extracts video and image metadata from Twitter/X links, including high-quality media links. If you’re looking for a **twitter video downloader**, a **download twitter video** workflow, or a **twitter x video downloader** for saving media at scale, this actor is built for you. Whether you’re a marketer, content analyst, or data researcher, it helps automate turning Twitter/X status URLs into usable direct media URLs—saving you hours of manual work. --- ### Why choose Twitter Video Downloader? | Feature | Benefit | |---|---| | ✅ **All-in-one media metadata extraction** | Extracts direct download links from each Twitter/X status URL in one run | | ✅ **Built-in proxy support** | Uses your selected proxy configuration for more reliable scraping | | ✅ **Resilient processing** | Includes error handling so failures for one URL don’t stop the whole batch | | ✅ **Structured JSON output** | Produces consistent fields for easy downstream analysis or exporting | | ✅ **Scales across multiple URLs** | Process an array of Twitter/X status URLs (batch-friendly input) | | ✅ **Real-time progress saving** | Pushes each result immediately so you can monitor output as it’s generated | --- ### Key features - 🎯 **Direct download URL extraction**: Returns a `downloadUrl` per provided Twitter/X status link - 🔗 **Status-to-media link normalization**: Detects shortened links in publicly available descriptions and resolves a usable `sourceUrl` - 🛡️ **Proxy-ready scraping**: Works with your chosen proxy configuration via Apify proxy settings - 🔄 **Isolated per-URL failures**: Errors are logged per input URL, while other URLs continue processing - 📊 **Clean, dataset-friendly structure**: Outputs consistent JSON with `sourceUrl` and `downloadUrl` for each scraped item - 💾 **Immediate dataset writes**: Each processed item is pushed to the dataset as soon as it’s ready - ⚡ **Batch processing support**: Submit multiple Twitter/X status URLs through `startUrls` in a single run - 🌐 **URL-based input workflow**: Accepts Twitter/X status URLs directly (built for “download twitter video” use cases) --- ### Input Provide input via an `input.json` file. Example structure: ```json { "startUrls": [ "https://x.com/TinaDebove/status/1967637722476212406" ], "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ```` #### Input Fields | Key | Required | Description | |---|---:|---| | `startUrls` | Yes | List of Twitter/X status URLs to scrape. Each item should be a full Twitter/X status link (e.g., `https://x.com/.../status/...`). | | `proxyConfiguration` | No | Proxy settings for the crawler. Use this to select how requests are routed. If omitted, the actor still relies on proxy setup logic internally. | | `proxyConfiguration` • `proxy support` | No | Enables Apify Proxy (recommended). In the default setup it’s set to `true`. | | `proxyConfiguration` • `proxy support` | No | Which proxy group(s) to use. In the default setup it includes `RESIDENTIAL`. | *** ### Output The actor saves each result in JSON format to the dataset. Each processed URL produces a record with the resolved `sourceUrl` and the direct `downloadUrl`. Example output record: ```json [ { "sourceUrl": "https://x.com/someuser/status/somestatus", "downloadUrl": "https://example.com/direct-media-link.mp4" } ] ``` #### Output Fields | Field | Type | Description | |---|---|---| | `sourceUrl` | string | The resolved source link. If a shortened `https://t.co/...` link is found in the status description, the actor uses it; otherwise it falls back to the original URL. | | `downloadUrl` | string | The direct media link extracted from the provided Twitter/X status URL (via the actor’s media extraction step). | > Note: Results are pushed immediately during processing, so partial outputs appear even if later URLs fail. *** ### How to use Twitter Video Downloader (via Apify Console) 1. **Open Apify Console**\ Log in at https://console.apify.com and open the **Actors** section. 2. **Find the actor**\ Search for **Twitter Video Downloader** and open the actor page. 3. **Go to the Input panel**\ Click the **INPUT** tab to configure your run. 4. **Paste your Twitter/X status links**\ In `startUrls`, add one or more URLs like `https://x.com//status/`. This is the core input for “twitter video downloader” and “twitter x video downloader” workflows. 5. **(Optional) Configure proxies**\ In `proxyConfiguration`, you can enable/adjust proxy routing (including `proxy support` and `proxy support`). This helps the actor run more reliably at scale. 6. **Run the actor**\ Click **Run**. Watch the logs—each URL is processed and errors are logged per URL if anything goes wrong. 7. **Review the dataset output**\ When finished (or while it’s running), open the **OUTPUT** tab to view the dataset. Each dataset item contains `sourceUrl` and `downloadUrl`, perfect for exporting or analysis. 8. **Export to your workflow**\ Export the dataset as needed (JSON/CSV depending on your preferences in the Apify UI). No coding required — get direct media links in minutes with this Twitter Video Downloader. *** ### Advanced features & SEO optimization - 🎬 **Engineered for “download twitter video” workflows**: Designed specifically around extracting direct media links from Twitter/X status URLs (great for “twitter video download free” research-style runs). - 🔗 **Short link resolution support**: If the status description includes `https://t.co/...` links, the actor uses that resolved `sourceUrl` as part of the result. - 🛡️ **Proxy reliability for batch runs**: Uses your proxy configuration to improve consistency when downloading multiple videos or media items. - 💾 **Real-time dataset pushing**: Each result is stored immediately, so you can track progress and start using data earlier. - 🔄 **Graceful handling across batches**: Failures for specific URLs are handled without stopping the entire run—useful when your `startUrls` list includes many items. *** ### Best use cases - 📈 **Content marketers bulk-saving video assets**: Quickly generate direct download links for a batch of Twitter/X posts to reuse in campaigns or reports. - 🔎 **Media researchers tracking creative formats**: Build a structured dataset of `downloadUrl` links to study how videos circulate over time. - 🧩 **Analysts comparing media quality over time**: Pull consistent direct media URLs so you can automate checks and audits across many status pages. - 🧑‍💻 **Developer pipelines for media enrichment**: Feed the dataset’s `downloadUrl` values into downstream tooling for storage or indexing. - 🗂️ **Social media managers curating libraries**: Organize “twitter reel downloader” style collections by harvesting media links from `startUrls`. - 📱 **Mobile/offline viewing workflows**: Use the `downloadUrl` outputs to support “download twitter video to phone” style offline media pipelines. *** ### Technical specifications - **Supported Input Formats** ✅ **Twitter/X status URLs** provided in `startUrls` (array of strings) - **Proxy Support** ✅ **Apify Proxy configuration** via `proxyConfiguration` (`proxy support`, `proxy support`) - **Retry Mechanism** ✅ **Error handling per URL** with logging (processing continues for other URLs) - **Dataset Structure** ✅ Each result item contains: - `sourceUrl` - `downloadUrl` - **Rate Limits & Performance** - Performance varies by URL and network/proxy conditions, but the actor processes the provided `startUrls` list sequentially and pushes results as they’re ready. - **Limitations** - ❌ If extraction fails for a specific URL, that URL’s result won’t be pushed successfully (the actor logs the error and continues). - ❌ Only data derivable from the provided Twitter/X links is returned (the actor outputs `sourceUrl` and `downloadUrl` as defined above). *** ### FAQ #### Does Twitter Video Downloader require login to Twitter/X? ✅ No login credentials are required in the provided actor input. You only need to supply `startUrls` containing Twitter/X status URLs. #### What types of links can I submit to Twitter Video Downloader? ✅ You should provide Twitter/X status URLs in `startUrls`. The actor processes each URL in your list and outputs `sourceUrl` and `downloadUrl`. #### What will I get back after the run finishes? ✅ The actor outputs a dataset where each item contains `sourceUrl` and `downloadUrl`, generated for each processed input URL. #### Can I run this for multiple Twitter/X videos at once? ✅ Yes. Submit many Twitter/X status URLs in the `startUrls` array to download media links in a single run. #### How does proxy configuration work? ✅ You can optionally provide `proxyConfiguration`. The schema supports `proxy support` and `proxy support` (with defaults defined in the actor input manifest). #### Is the output saved while the actor is still running? ✅ Yes. The actor pushes each result immediately during processing, which helps you monitor progress and start using partial results sooner. #### Can I export the results to CSV or JSON? ✅ The actor saves results to the Apify dataset. You can then export from the Apify UI in common formats like JSON/CSV based on your settings. *** ### Support & feature requests If you’re using Twitter Video Downloader for **twitter video downloader** workflows and want improvements, we’d love to hear from you. - 💡 **Feature Requests**: Examples include expanding output fields, adding additional media formats, or supporting more input convenience options for “twitter x video downloader” style usage. - 📧 **Contact**: Reach out via . Your feedback helps shape the roadmap for Twitter Video Downloader. *** - *Twitter Video Downloader is a practical, dataset-ready way to extract direct media links from Twitter/X statuses—ideal for teams and analysts who need reliable “download twitter video” outputs at scale.* \* *** ### Disclaimer **This tool only accesses publicly accessible sources** available from the provided Twitter/X status links. It does not access private profiles or password-protected data. Legal compliance (including GDPR, CCPA, spam regulations, and platform terms) is your responsibility. For data-removal requests, contact . Use this actor responsibly, ethically, and only for legitimate purposes. # Actor input Schema ## `startUrls` (type: `array`): List of Twitter/X status URLs to scrape. ## `proxyConfiguration` (type: `object`): Select proxies to be used by your crawler. ## Actor input object example ```json { "startUrls": [ "https://x.com/TinaDebove/status/1967637722476212406" ], "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # 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("solid-scraper/twitter-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("solid-scraper/twitter-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 solid-scraper/twitter-video-downloader --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=solid-scraper/twitter-video-downloader", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Twitter Video Downloader", "description": "🚀 Download Twitter (X) videos fast with Twitter Video Downloader! Save in seconds, keep quality, and watch offline anytime 📥📺 Perfect for creators, marketers, and fans—simple, secure, and efficient. Try it now!", "version": "0.1", "x-build-id": "RTw7bIWgkecvljDUd" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solid-scraper~twitter-video-downloader/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solid-scraper-twitter-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/solid-scraper~twitter-video-downloader/runs": { "post": { "operationId": "runs-sync-solid-scraper-twitter-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/solid-scraper~twitter-video-downloader/run-sync": { "post": { "operationId": "run-sync-solid-scraper-twitter-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" } }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Select proxies to be used by your crawler.", "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 } } }, "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 } } } } } } } } } } ```