# Twitter X Downloader (`serpdownloaders/twitter-x-downloader`) Actor Twitter X Downloader helps you save publicly accessible X videos, clips, and media for offline viewing and reference. It is designed for a fast local-first workflow so teams can keep research, client examples, and archives organized without relying on live links. - **URL**: https://apify.com/serpdownloaders/twitter-x-downloader.md - **Developed by:** [SERP Downloaders](https://apify.com/serpdownloaders) (community) - **Categories:** Videos, Automation, Social media - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## 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 Downloader > Download videos, images, and post text from X in one browser workflow. ![Twitter X Downloader](https://raw.githubusercontent.com/serpdownloaders/twitter-x-downloader/main/assets/workflow-preview.webp) Twitter X Downloader is a browser extension built for users who want a simpler way to save X content for offline reference. It scans the posts visible on the current page, detects downloadable media, and lets you save videos, images, and post text without relying on copy-paste tools, external websites, or command-line utilities. - Save X videos as MP4 files for offline viewing - Download post images in their available source format - Export post text for notes, research, or archiving - Bulk-download visible content from the current page - Organize saved files for easier local reference ### Get it Here Get it here: https://serp.ly/twitter-x-downloader ### Table of Contents - [Why Twitter X Downloader](#why-twitter-x-downloader) - [Features](#features) - [How It Works](#how-it-works) - [Step-by-Step Tutorial: How to Download Content from X](#step-by-step-tutorial-how-to-download-content-from-x) - [Supported Formats](#supported-formats) - [Who It's For](#who-its-for) - [Common Use Cases](#common-use-cases) - [Troubleshooting](#troubleshooting) - [Trial & Access](#trial--access) - [Installation Instructions](#installation-instructions) - [FAQ](#faq) - [Notes](#notes) - [About X](#about-x) ### Why Twitter X Downloader X does not provide a clean export flow for mixed post assets like video, images, and text. Videos are streamed, image sets are mixed into dynamic layouts, and copying post text manually is tedious if you are building a clean local archive or research folder. Twitter X Downloader is built for that exact workflow. It scans visible X posts, groups the detected media, and gives you a direct way to save useful content from the current page in a more organized format. ### Features - Video detection for X feed posts, profiles, and threads - Image detection for visible post media - Post text export for visible posts on the page - Bulk-download workflow for all visible content in the current view - Overlay buttons for faster in-feed downloads - MP4 video saving where X exposes downloadable video streams - Source-format image saving where available - TXT export for post text - Cross-browser support for Chrome, Edge, Brave, Opera, Firefox, Whale, and Yandex ### How It Works 1. Install the extension from the latest release. 2. Open X and go to a feed, profile, or thread. 3. Scroll until the posts you want are visible on the page. 4. Open the extension popup to review detected videos, images, and text. 5. Download individual items or use the bulk option for everything visible. 6. Save the exported files locally for offline access. ### Step-by-Step Tutorial: How to Download Content from X 1. Install Twitter X Downloader from the latest GitHub release. 2. Sign in to X if the posts you want require login to view. 3. Open the feed, profile, or thread you want to save from. 4. Scroll until the target posts and media are visible on the page. 5. Click the extension button to scan the current view. 6. Review the detected videos, images, and text entries. 7. Download individual items or run a bulk download for everything visible. 8. Open the saved files from your Downloads folder. ### Supported Formats - Video: MP4 - Images: JPG, PNG, and other source formats where available - Text: TXT Saved text exports are designed for cleaner offline reference and note-taking. ### Who It's For - X users saving posts for offline reference - Content creators archiving their own media and post text - Researchers, journalists, and analysts collecting public posts - Social media managers curating examples or campaign material - Anyone who wants a browser-based workflow instead of using third-party download sites ### Common Use Cases - Save a video from an X post for offline viewing - Download all images from a post or thread - Export post text into plain text files for research or notes - Bulk-download visible content from a profile page - Archive your own media and posts into a local folder ### Troubleshooting **The extension is not finding a post video** Make sure the post is fully visible and the video has loaded on the page before scanning. **The image you want is missing** Scroll the post into full view and rescan. The extension only captures media that is currently visible. **The bulk download missed some posts** Scroll further so more posts load, then scan again. X uses dynamic page loading, so not every post is present at once. **The text export looks incomplete** Expand long posts before scanning so the full text is visible in the browser. **The post requires login or restricted access** The extension only works on content you can already access in your current X session. ### Trial & Access - Includes **3 free downloads** so you can test the workflow first - Email sign-in uses secure one-time password verification - No credit card required for the trial - Unlimited downloads are available with a paid license Start here: [https://serp.ly/twitter-x-downloader](https://serp.ly/twitter-x-downloader) ### Installation Instructions 1. Open the latest release page: [https://github.com/serpdownloaders/twitter-x-downloader/releases/latest](https://github.com/serpdownloaders/twitter-x-downloader/releases/latest) 2. Download the extension build for your browser. 3. Install the extension. 4. Open X and navigate to a feed, profile, or thread. 5. Use the extension popup to scan and download visible content. ### FAQ **What kinds of content can I download from X?** Videos, images, and post text from supported X pages. **What file formats are used?** Videos are saved as MP4, images are saved in the source format when available, and post text is exported as TXT. **Can I bulk-download everything visible?** Yes. The extension supports bulk export for content currently visible on the page. **Do I need to use an external website or bot?** No. Everything runs directly in the browser extension. **Where are files saved?** They are saved to your default Downloads location. **Do I need extra software?** No. Everything runs through the browser extension. ### License This repository is distributed under the proprietary SERP Apps license in the [LICENSE](https://github.com/serpdownloaders/twitter-x-downloader/blob/main/LICENSE) file. Review that file before copying, modifying, or redistributing any part of this project. ### Notes - Only download content you own or have explicit permission to save - The extension only captures content currently visible on the page - Scroll to load more posts before scanning if you want a larger batch - Video quality depends on the streams X exposes for that post - Respect platform rules and the rights of original content owners ### About X X is a social platform built around short posts, media sharing, live conversations, and trending content. While it is designed for fast browser and mobile consumption, it does not provide a simple native workflow for exporting mixed post assets like video, images, and text together. Twitter X Downloader simplifies that process for users who need a cleaner local archive workflow. # Actor input Schema ## `listingNotice` (type: `string`): Optional informational field only. This actor currently serves as the public listing surface for the browser extension and does not yet expose a finalized runtime API contract. ## Actor input object example ```json { "listingNotice": "No runtime input is required yet. See the README and product page for the current extension workflow." } ```` # 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 = {}; // Run the Actor and wait for it to finish const run = await client.actor("serpdownloaders/twitter-x-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 = {} # Run the Actor and wait for it to finish run = client.actor("serpdownloaders/twitter-x-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 '{}' | apify call serpdownloaders/twitter-x-downloader --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=serpdownloaders/twitter-x-downloader", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Twitter X Downloader", "description": "Twitter X Downloader helps you save publicly accessible X videos, clips, and media for offline viewing and reference. It is designed for a fast local-first workflow so teams can keep research, client examples, and archives organized without relying on live links.", "version": "0.0", "x-build-id": "SwMJM93mdMY1qF2RW" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/serpdownloaders~twitter-x-downloader/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-serpdownloaders-twitter-x-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/serpdownloaders~twitter-x-downloader/runs": { "post": { "operationId": "runs-sync-serpdownloaders-twitter-x-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/serpdownloaders~twitter-x-downloader/run-sync": { "post": { "operationId": "run-sync-serpdownloaders-twitter-x-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", "properties": { "listingNotice": { "title": "Listing notice", "type": "string", "description": "Optional informational field only. This actor currently serves as the public listing surface for the browser extension and does not yet expose a finalized runtime API contract.", "default": "No runtime input is required yet. See the README and product page for the current extension workflow." } } }, "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 } } } } } } } } } } ```