# Twitter X Image Downloader (`scrapevanta/twitter-x-image-downloader`) Actor Twitter X Image Downloader lets you download high-quality images from X (Twitter) posts in seconds. Save single or multiple photos, preserve original resolution, and export images for research, content creation, archiving, and social media analysis with ease. - **URL**: https://apify.com/scrapevanta/twitter-x-image-downloader.md - **Developed by:** [ScrapeVanta](https://apify.com/scrapevanta) (community) - **Categories:** Social media, Automation, Lead generation - **Stats:** 1 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $5.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 (X.com) Image Downloader ⚡ — Grab images and metadata from post links fast Manually opening Twitter (X.com) posts and copying image links takes forever—especially when you have dozens of posts to process. **Twitter (X.com) Image Downloader** extracts image metadata and the best available thumbnail from each provided Twitter/X status URL. It’s a practical **Twitter image downloader** and **X.com image downloader** for marketers, analysts, and researchers who need fast, structured results. Use it to turn a list of Twitter (X.com) links into a clean dataset you can review and export in minutes—not hours. --- ### See the Data: Sample Output Here's a real record from a single run: ```json { "success": true, "tweet_url": "https://x.com/iamsrk/status/1994361290421383203", "metadata": { "title": "Some post title text", "twitter_id": "1994361290421383203", "thumbnail": "https://pbs.twimg.com/media/EXAMPLE_thumbnail.jpg", "image_count": 1 }, "images": [ { "format": "jpg", "width": 1200, "height": 675, "resolution": "1200x675", "url": "https://pbs.twimg.com/media/EXAMPLE_image.jpg" } ] } ```` If a URL can’t be processed, the actor returns an error record in the same dataset: ```json { "success": false, "tweet_url": "https://x.com/iamsrk/status/INVALID_OR_UNAVAILABLE", "error": "Some error message" } ``` | Field | Type | What It Tells You | |---|---|---| | `success` | boolean | Whether the post was processed successfully (true) or failed (false) | | `tweet_url` | string | The exact Twitter/X status URL that was attempted | | `error` | string | Present when `success` is false—useful for troubleshooting failed inputs | | `metadata` | object | Post-level info that helps you label and filter results | | `metadata.title` | string | A cleaned title/description extracted from the post metadata | | `metadata.twitter_id` | string | The extracted status ID from the URL (or the extracted `id` value when available) | | `metadata.thumbnail` | string | The thumbnail URL (parameters stripped if present) | | `metadata.image_count` | number | How many images entries were produced for this post | | `images` | array | The image entries for the post (typically the best matching thumbnail-derived image) | | `images[].format` | string | Image format for the output entry (the actor sets it to `jpg`) | | `images[].width` | number | Output width (the actor uses `1200`) | | `images[].height` | number | Output height (the actor uses `675`) | | `images[].resolution` | string | The resolution string in the format `1200x675` | | `images[].url` | string | Present when key-value mode is off—direct image URL for the selected thumbnail-derived image | | `images[].kv_store_url` | string | Present when key-value mode is on—URL pointing to a record in a key-value store (simulated) | Export your full dataset as JSON, CSV, or Excel from the Apify dashboard. *** ### Setting It Up Drop this into your `input.json` and you're ready to go: ```json { "post_urls": [ "https://x.com/iamsrk/status/1994361290421383203" ], "key_value": false } ``` | Parameter | Required | What It Does | |---|---|---| | `post_urls` | ✅ | A list of Twitter/X status URLs to scrape for images and metadata | | `key_value` | ⬜ | If `true`, the actor generates `kv_store_url` links for each image entry (simulated); when `false`, it returns `images[].url` | *** ### What It Does Twitter (X.com) Image Downloader processes each provided Twitter/X post URL and outputs structured image metadata plus a usable image reference per post. #### Extract images and post metadata in one run For every status URL you provide, the actor produces a result record with `metadata` (including `title`, `twitter_id`, `thumbnail`, and `image_count`) and an `images` array. #### Prioritizes a high-quality thumbnail match The actor looks for the most suitable thumbnail data and outputs image entries with a fixed `format` of `jpg` and resolution details set to `1200x675`. #### Clean, integration-ready output for downstream work Results are pushed per URL, and each record contains consistent fields like `success`, `tweet_url`, `metadata`, and `images`, so you can import into spreadsheets or analytics workflows with minimal cleanup. #### Works with a simple “direct URL” or key-value link mode When `key_value` is `false`, the actor includes `images[].url`. When `key_value` is `true`, it instead includes `images[].kv_store_url`, which can be useful when you want URL references in a simulated key-value workflow. #### Handles failures without blocking the whole dataset If a given post URL fails, the actor still adds a dataset entry with `success: false` and an `error` message for that specific `tweet_url`, so you can see what needs reprocessing. Overall, Twitter (X.com) Image Downloader turns Twitter/X links into structured image data you can review, export, and reuse. *** ### Why Twitter (X.com) Image Downloader? There are plenty of ways to pull data from Twitter/X—here’s why Twitter (X.com) Image Downloader stands out. #### Designed for fast batch processing Instead of one-off copying, you submit a list of `post_urls` and get back structured results per URL—ideal for saving time when you’re doing a **Twitter image downloader** workflow at scale. #### Consistent JSON structure for easier analysis Each result includes the same core fields (`success`, `tweet_url`, `metadata`, `images`), which makes it easier to filter, join, and validate in tools like spreadsheets and data pipelines—perfect for an **X.com image downloader** use case. #### Resilient per-URL error reporting When something goes wrong for a specific post, you still receive a dataset record with `success: false` and the `error` text, so you can audit failures and improve your inputs without losing other results. *** ### Real-World Use Cases Here's how different teams put Twitter (X.com) Image Downloader to work: **Marketing Teams**\ A campaign manager collects a list of Twitter/X posts from multiple creators, then runs Twitter (X.com) Image Downloader to pull consistent thumbnail metadata and image references into one dataset. They can quickly audit which creatives perform best using `metadata.title`, `metadata.thumbnail`, and `image_count`, then export for a content review workflow. **Freelance Researchers**\ A researcher needs to document visual artifacts from public Twitter/X posts across a time window. They feed the status URLs into the actor, then use the resulting `metadata.twitter_id` and `tweet_url` mapping to organize evidence and keep a clean audit trail of what was captured. **Product & Automation Developers**\ A developer building an internal dashboard wants image references and basic post context without manual steps. They run Twitter image downloader jobs from predefined `post_urls`, then ingest the JSON records into their system where `metadata` fields and `images` entries can be used to populate UI cards or downstream tasks. **Content Operations & QA**\ A social media operator checks brand consistency across reposts and curated threads by downloading image references and thumbnails for a list of posts. With consistent `images[].resolution` and `images[].format`, they can quickly flag missing or unexpected image variants. **Data Analysts**\ An analyst combines image references with external datasets (like campaign metadata) by joining on `metadata.twitter_id` and `tweet_url`. Since the actor outputs structured `images` and `metadata` together, it becomes straightforward to compute counts and review failures by `error`. *** ### How to Run It No code required. Here's how to get your first results in under 5 minutes: 1. **Open the actor page on Apify**\ Go to the actor listing on Apify via [console.apify.com](https://console.apify.com). 2. **Enter your inputs**\ Add your Twitter/X status URLs in `post_urls`. Optionally set `key_value` to `true` if you want `images[].kv_store_url` instead of `images[].url`. 3. **Configure proxy settings (optional)**\ If you have a specific proxy setup you want to use, configure it in the actor run settings. Otherwise, you can run with defaults. 4. **Start the run and watch the live log**\ Submit the run and monitor progress; each provided URL is processed and results are pushed as they’re ready. 5. **Open the Dataset tab to see live results**\ You’ll see records with `success`, `tweet_url`, `metadata`, and `images`, including error records when `success` is `false`. 6. **Export in your preferred format**\ Download as JSON, CSV, or Excel directly from the Apify dashboard. The whole setup takes under 5 minutes — results start appearing within seconds of launch. *** ### Export & Integration Options Once your data is collected, Twitter (X.com) Image Downloader fits directly into your existing workflow. You can export results from the Apify dataset tab as JSON, CSV, or Excel, which is ideal for reporting, audits, and analysis. If you’re integrating into automation, you can use Apify’s native dataset/API options or connect the run to downstream systems via tools like Zapier or Make. The dataset records are structured with fields like `tweet_url`, `metadata`, and `images`, so integration is straightforward. *** ### Pricing Twitter (X.com) Image Downloader runs on Apify, which includes a **free tier** — no credit card needed to start. You’ll typically begin with a small amount of usage to validate your `post_urls` input and confirm the output quality. For larger batches, you scale using Apify’s pay-as-you-go compute model, and you can review plan options on the Apify pricing page. Start free at [apify.com](https://apify.com) — scale up when you need to. *** ### Reliability & Limitations | What We Handle | How | |---|---| | Per-URL failures | Failed URLs still produce dataset entries with `success: false` and an `error` field | | Retry behavior | The actor attempts processing multiple times per URL to improve resilience | | Quality thumbnail selection | Outputs consistent thumbnail-derived image references with resolution details set to `1200x675` | | Output consistency | Each result follows a stable structure: `success`, `tweet_url`, `metadata`, and `images` | **Limitations:** The actor works with Twitter/X post URLs you provide and extracts publicly accessible image metadata and thumbnail-derived references. If a post cannot be processed for any reason, you’ll see that reflected in the dataset via `success: false` and the `error` field. Private or login-gated content is not in scope. For enterprise-scale needs or custom configurations, reach out and we’ll help. *** ### Frequently Asked Questions #### Is there a free plan? Yes. Apify offers a free tier with monthly usage credits, which is enough for several real test runs for most onboarding scenarios. #### Do I need to log in or create an account on Twitter (X.com)? No. This actor extracts image metadata and thumbnail-derived information from Twitter/X status URLs you provide, without requiring a Twitter/X login. #### How accurate is the extracted data? The actor extracts structured metadata fields like `title`, `twitter_id`, `thumbnail`, and image entries with `images[].resolution` details from what it can retrieve for each status URL. If a specific post doesn’t provide usable image data, you’ll see it reflected in `image_count` and the presence of `images`. #### How many results can I get per run? You can include as many links as you need in `post_urls`—the actor processes each URL and adds a dataset record for each one (including error records). #### How fresh is the data? The results reflect the moment your run processes each provided `post_urls` entry. If you re-run with the same URLs later, you may see changes in `metadata` such as `thumbnail` or related info. #### Is this legal? Does it comply with GDPR / CCPA? Yes in the sense that it targets **publicly available data** and returns structured results. You’re responsible for using the output lawfully and in compliance with GDPR, CCPA, and Twitter/X Terms of Service. #### Can I export to Google Sheets or Excel? Yes. You can download the dataset as JSON, CSV, or Excel from the Apify dashboard, and then import it into Google Sheets or your spreadsheet tool of choice. #### Can I schedule this to run automatically? Yes. You can schedule Apify actor runs using Apify’s scheduling capabilities so your dataset stays updated on a cadence you choose. #### Can I access results via the API? Yes. You can retrieve your run’s dataset results programmatically using Apify’s API options. #### What happens when the actor encounters an error? For a failing `tweet_url`, the actor adds a record with `success: false`, includes the `tweet_url`, and provides an `error` string so you can quickly see what went wrong and re-run only the affected inputs. *** ### Get Help & Use Responsibly Got a question about Twitter (X.com) Image Downloader or a feature you'd like added? Reach out at . We’re happy to help with input formatting tips and can prioritize enhancements like improved handling for batch inputs or expanded output fields. **This actor collects and returns *publicly available data*.** It does **not** access private accounts, login-gated pages, or password-protected content. You’re responsible for complying with GDPR, CCPA, and Twitter/X Terms of Service when using the results. For data removal requests, contact . Use responsibly, ethically, and only for lawful purposes. # Actor input Schema ## `post_urls` (type: `array`): List of Twitter/X status URLs to scrape. ## `key_value` (type: `boolean`): If true, generates URLs pointing to records in the key-value store (simulated). ## Actor input object example ```json { "post_urls": [ "https://x.com/iamsrk/status/1994361290421383203" ], "key_value": false } ``` # 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 = { "post_urls": [ "https://x.com/iamsrk/status/1994361290421383203" ] }; // Run the Actor and wait for it to finish const run = await client.actor("scrapevanta/twitter-x-image-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 = { "post_urls": ["https://x.com/iamsrk/status/1994361290421383203"] } # Run the Actor and wait for it to finish run = client.actor("scrapevanta/twitter-x-image-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 '{ "post_urls": [ "https://x.com/iamsrk/status/1994361290421383203" ] }' | apify call scrapevanta/twitter-x-image-downloader --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=scrapevanta/twitter-x-image-downloader", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Twitter X Image Downloader", "description": "Twitter X Image Downloader lets you download high-quality images from X (Twitter) posts in seconds. Save single or multiple photos, preserve original resolution, and export images for research, content creation, archiving, and social media analysis with ease.", "version": "0.1", "x-build-id": "7SzC4yp4qlszt8nW6" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapevanta~twitter-x-image-downloader/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapevanta-twitter-x-image-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/scrapevanta~twitter-x-image-downloader/runs": { "post": { "operationId": "runs-sync-scrapevanta-twitter-x-image-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/scrapevanta~twitter-x-image-downloader/run-sync": { "post": { "operationId": "run-sync-scrapevanta-twitter-x-image-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": [ "post_urls" ], "properties": { "post_urls": { "title": "Post URLs", "type": "array", "description": "List of Twitter/X status URLs to scrape.", "items": { "type": "string" } }, "key_value": { "title": "Use Key-Value Store", "type": "boolean", "description": "If true, generates URLs pointing to records in the key-value store (simulated).", "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 } } } } } } } } } } ```