Twitter (X) Media Downloader

What it returns

27 fields from the published dataset schema. Export as JSON, CSV or Excel, or read the dataset through the Apify API.

• typemedia file for a downloaded file, status for a run message.
• tweetIdNumeric ID of the post the media belongs to.
• tweetUrlCanonical URL of the post.
• mediaTypevideo, photo or gif.
• mediaUrlMedia URL with the selected photo quality applied (videos/GIFs use the chosen stream).
• mediaUrlOriginalUntouched X CDN URL of the media, without the quality parameter.
• thumbnailUrlPreview/poster image URL for videos and GIFs.
• posterImageUrlPoster image URL on video/GIF rows when includePosterImage is on, with the selected photo quality applied.
• altTextImage description X stores for the photo or video thumbnail.
• filenameFile name used in the key-value store.
• fileSizeBytesReal size of the downloaded file.
• widthMedia width in pixels.
• heightMedia height in pixels.
• durationSecondsVideo or GIF duration.
• audioFormatAudio container used when the audio-only option is on.
• downloadUrlPublic signed download link for the stored file.
• downloadStatusfinished, failed or notDownloaded.
• uploaderUsernameHandle of the account that posted the media.
• tweetTextText of the post.
• likeCountNumber of likes on the post.
• retweetCountNumber of reposts on the post.
• viewCountNumber of views on the post.
• mediaSourcepost for the post's own media, quoted post for media inside a quoted post, poster image for a video thumbnail.
• statusStatus code on status rows.
• messageHuman-friendly status or failure message.
• usernameUsername related to a status row.
• collectedAtUTC timestamp when the row was created.

Not in the schema among the core X (Twitter) fields: post_id, author, posted_at, reposts. The field matrix shows which other tools return them.

How it differs from the other X (Twitter) Actors

Every field it publishes also appears in at least one of the other 11 catalogue Actors for X (Twitter) with a schema, so pick on price, input options and the fields below.

Pick another Actor if you need

Input

Example input

Built from the input form's published example values and defaults.

{
  "postUrls": [
    "https://x.com/NASA/status/2107095768821576019"
  ],
  "maxPostsPerUser": 1,
  "maxItems": 1,
  "mediaTypes": [
    "video",
    "photo",
    "gif"
  ],
  "imageQuality": "orig",
  "videoQuality": "best",
  "downloadAllQualities": false,
  "includePosterImage": false,
  "includeAltText": true,
  "audioOnly": false,
  "audioFormat": "m4a",
  "includeQuotedMedia": true,
  "includeMetadata": true,
  "minLikes": 0,
  "minRetweets": 0,
  "onlyVerifiedAuthors": false,
  "saveToFile": false
}

Run it from code or an AI agent

The same run through the Apify API, with the example input. You need an Apify API token; the run is billed to your account at the Store price.

from apify_client import ApifyClient

client = ApifyClient("<YOUR_APIFY_TOKEN>")
run_input = {
    "postUrls": [
        "https://x.com/NASA/status/2107095768821576019"
    ],
    "maxPostsPerUser": 1,
    "maxItems": 1,
    "mediaTypes": [
        "video",
        "photo",
        "gif"
    ],
    "imageQuality": "orig",
    "videoQuality": "best",
    "downloadAllQualities": False,
    "includePosterImage": False,
    "includeAltText": True,
    "audioOnly": False,
    "audioFormat": "m4a",
    "includeQuotedMedia": True,
    "includeMetadata": True,
    "minLikes": 0,
    "minRetweets": 0,
    "onlyVerifiedAuthors": False,
    "saveToFile": False
}

run = client.actor("dataspryva/twitter-x-media-downloader").call(run_input=run_input)
if run is None:
    raise RuntimeError("The Actor run was not found.")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

import { ApifyClient } from "apify-client";

const client = new ApifyClient({ token: "<YOUR_APIFY_TOKEN>" });
const input = {
    "postUrls": [
        "https://x.com/NASA/status/2107095768821576019"
    ],
    "maxPostsPerUser": 1,
    "maxItems": 1,
    "mediaTypes": [
        "video",
        "photo",
        "gif"
    ],
    "imageQuality": "orig",
    "videoQuality": "best",
    "downloadAllQualities": false,
    "includePosterImage": false,
    "includeAltText": true,
    "audioOnly": false,
    "audioFormat": "m4a",
    "includeQuotedMedia": true,
    "includeMetadata": true,
    "minLikes": 0,
    "minRetweets": 0,
    "onlyVerifiedAuthors": false,
    "saveToFile": false
};

const run = await client.actor("dataspryva/twitter-x-media-downloader").call(input);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

curl -X POST "https://api.apify.com/v2/actors/dataspryva~twitter-x-media-downloader/run-sync-get-dataset-items"   -H "Authorization: Bearer $APIFY_TOKEN"   -H "Content-Type: application/json"   -d '{"postUrls":["https://x.com/NASA/status/2107095768821576019"],"maxPostsPerUser":1,"maxItems":1,"mediaTypes":["video","photo","gif"],"imageQuality":"orig","videoQuality":"best","downloadAllQualities":false,"includePosterImage":false,"includeAltText":true,"audioOnly":false,"audioFormat":"m4a","includeQuotedMedia":true,"includeMetadata":true,"minLikes":0,"minRetweets":0,"onlyVerifiedAuthors":false,"saveToFile":false}'

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com?tools=dataspryva/twitter-x-media-downloader",
      "headers": {
        "Authorization": "Bearer <YOUR_APIFY_TOKEN>"
      }
    }
  }
}

What a run costs

The result rate falls on higher Apify plans. Each figure is the published per-result rate times the number of results.

• Every run also has a start event, charged per GB of memory (minimum one): $0.10 on Free, $0.03 on Business. At its default memory of 4 GB a run starts at $0.40 on Free. Fewer, larger runs keep this small.
• The Free plan includes $5 of monthly usage (Apify pricing, checked 2026-11-11); at the Free rate that covers at most about 5,050 results, less start events and platform usage.
• Worked example: 10,000 results in one run on the Free plan cost $10.30 ($9.90 for results + $0.40 start), plus Apify platform usage (compute), billed separately by Apify.
• Pay per event. Platform usage (compute) is billed by Apify on top of the event prices. Compare other tools in the cost estimator.

Where it fits among X (Twitter) routes

It ranks 1 of 12 catalogue Actors for X (Twitter) on the published formula (fields, price, reliability, freshness). Its line is highlighted on the map.

What people use it for

• Download post media
• Collect media metadata
• Extract audio tracks

Other catalogue Actors for X (Twitter)

Similar Actors

Questions people ask

Sources

• Twitter (X) Media Downloader on Apify Store
• Published build with input and output schema (JSON)
• X API v2 documentation