# Reddit Media Downloader (`solid-scraper/reddit-media-downloader`) Actor 📹 Reddit Media Downloader lets you effortlessly save photos, GIFs, and videos from Reddit in seconds. ⚡ Fast, user-friendly, and efficient—ideal for creators, researchers, and fans who want offline access anytime. - **URL**: https://apify.com/solid-scraper/reddit-media-downloader.md - **Developed by:** [SolidScraper](https://apify.com/solid-scraper) (community) - **Categories:** Social media, Automation, Videos - **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 ### Reddit Media Downloader 📥 **Reddit Media Downloader** extracts high-quality videos and images/media from Reddit posts so you can quickly download and reuse the content you care about—without manual copy-paste work. If you’re looking for a **Reddit video downloader**, **download reddit videos**, or a **Reddit media downloader app** style workflow, this actor helps streamline the process of **Reddit post media downloader** tasks at scale. It’s designed for marketers, researchers, content teams, and data analysts who want to **download Reddit audio**, **download Reddit images**, or pull out **Reddit GIF downloader**-style media outcomes from public web data, saving you hours of manual work. --- ### Why choose Reddit Media Downloader? | Feature | Benefit | | --- | --- | | ✅ All-in-one Reddit post media extraction | Pulls together the results for each Reddit post URL in one run. | | ✅ Reliability-focused scraping | Includes resilience via built-in proxy support for more consistent extraction. | | ✅ Clear success/failure signaling | Returns an `error` result when media can’t be extracted, so your pipeline stays predictable. | | ✅ Structured JSON output | Produces a consistent JSON object with `title`, `thumbnail`, and downloadable media URLs. | | ✅ Scale-friendly batch processing | Handles multiple Reddit post URLs from the `urls` input list in a single run. | | ✅ Automation-ready results | Each input URL is pushed immediately with a consistent schema for downstream processing. | --- ### Key features - 🎥 **Reddit video and audio media extraction**: Extracts media items as MP4 video URLs (and audio items when available) for each Reddit post. - 🖼️ **Thumbnail + post metadata included**: Captures `title` and a usable `thumbnail` URL (when available). - 🌐 **Flexible URL input support**: Accepts a list of Reddit post URLs via the `urls` array for bulk extraction. - 🛡️ **Proxy support for reliable scraping**: Built-in proxy support helps maintain steady access across batches. - 🔄 **Resilient execution flow**: Uses fallbacks and structured error handling so failures don’t break the whole run. - 💾 **Real-time data saving**: Pushes each processed URL’s result as output data during execution. - 📦 **Multiple media items per post**: Returns a `medias` array (e.g., multiple video qualities and/or audio representations). - 🚀 **Automation-friendly**: Outputs direct media URLs you can feed into your **Reddit MP4 downloader** or **Reddit reels downloader** workflows. --- ### Input Provide input via an `input.json` file. Example structure: ```json { "urls": [ "https://www.reddit.com/r/ChatGPT/comments/1t99m84/the_spaghetti_benchmark/" ] } ```` #### Input Fields | Field | Required | Description | | --- | --- | --- | | `urls` | Yes | A list of Reddit post URLs to scrape for downloadable media. Provide one or many links in this array (e.g., Reddit post pages). | *** ### Output The actor saves each processed URL’s data as JSON, pushed per input item. Example output item pushed by the actor: ```json { "url": "https://www.reddit.com/r/ChatGPT/comments/1t99m84/the_spaghetti_benchmark/", "result": { "url": "https://v.redd.it/unknown", "source": "reddit", "title": "Example title", "thumbnail": "https://example.com/thumbnail.jpg", "medias": [ { "type": "video", "maxquality": false, "quality": "720p", "url": "https://v.redd.it/unknown/DASH_720.mp4", "info": { "bandwidth": "123456", "codecs": "avc1.4d401f", "frameRate": "30", "height": "720", "id": "720", "mimeType": "video/mp4", "width": "1280" }, "extension": "mp4" } ], "type": "multiple", "error": false, "time_end": 1456 } } ``` #### Output Fields | Field | Type | Description | | --- | --- | --- | | `url` | string | The input Reddit post URL that was processed. | | `result` | object | The extraction result object for that input URL. | | `result.url` | string | A media source URL for the extracted content (the actor returns a `v.redd.it` URL). | | `result.source` | string | Indicates the source of the media extraction (returns `reddit`). | | `result.title` | string | The Reddit post title (when available from the post data). | | `result.thumbnail` | string | Thumbnail URL for the post media (best-effort; may be a preview image when the default thumbnail is not usable). | | `result.medias` | array | List of extracted media entries (videos and/or audio entries, depending on the post). | | `result.type` | string | Media result type returned by the actor (returns `multiple` when extraction succeeds). | | `result.error` | boolean | Indicates whether the extraction failed (`true`/`false`). | | `result.time_end` | number | A time value included in the actor’s response payload (present when extraction succeeds). | | `result.error` / `result.message` | — | When extraction fails, `result` is returned as an object containing `error: true` and a `message` (either “Failed to extract media” or the exception string). | > Note: Each media entry inside `result.medias` includes fields like `type`, `quality`, `url`, `info`, and `extension` (for example, `extension` is returned as `"mp4"` for video and `"mp3"` for audio entries). *** ### How to use Reddit Media Downloader (via Apify Console) 1. **Open Apify Console**\ Log in at [console.apify.com](https://console.apify.com) and go to the **Actors** section. 2. **Find Reddit Media Downloader**\ Search for **Reddit Media Downloader** and open the actor page. 3. **Go to the INPUT tab**\ You’ll see the input form. Paste your JSON or use the form fields. 4. **Enter your Reddit post URLs**\ In the `urls` list, add one or more Reddit post links you want to extract media from. 5. **(Optional) Configure proxy settings**\ The actor supports proxy configuration for more reliable scraping during batches. 6. **Run the actor**\ Click **Run** to start. Watch the logs as each URL is processed. The actor includes a small delay between items to be polite during batch runs. 7. **Open the OUTPUT dataset**\ After the run, open the **Dataset** tab to view the pushed JSON results. 8. **Export your results**\ Export the dataset in the format you need for your workflow (e.g., JSON for further processing). No coding required—get results from your Reddit media downloader workflow in minutes. 🚀 *** ### Advanced features & SEO optimization - 🧩 **Engineered for “Reddit media downloader app” workflows**: Built specifically to extract usable media URLs from Reddit posts so you can build your own **Reddit MP4 downloader** pipeline. - 🛡️ **Resilience and fallbacks**: Uses built-in proxy support and structured error handling to keep large batches moving. - 🔍 **Post context included**: Alongside media URLs, you also get `title` and `thumbnail` where available—helpful for organizing datasets and reporting. - 💾 **Automation-ready JSON**: Consistent output makes it easier to power downstream “download Reddit audio”, “download Reddit images”, or “Reddit GIF downloader”-style needs. - 📊 **Batch-friendly**: Submit many `urls` at once to speed up “download reddit videos” tasks. *** ### Best use cases - 📈 **Marketing teams for short-form content research**: Quickly extract **Reddit post media downloader** assets for trend analysis and content inspiration. - 🧠 **Researchers and academics**: Build structured datasets from public web media and keep metadata like `title` and `thumbnail` for referencing. - 🎬 **Creators and editors**: Download and organize videos/audio assets for remixing workflows using a dedicated **Reddit reels downloader** approach. - 🖼️ **Design and meme curators**: Pull images and media quickly as part of a **Reddit gallery downloader** process. - 📣 **Social media analysts**: Compare how media types (video/audio) appear across posts by collecting standardized results per URL. - 💻 **Developer pipelines**: Feed extracted MP4 (and audio when available) links into your automation stack for “Reddit downloader online free” style internal tooling. *** ### Technical specifications - **Supported Input Formats** - ✅ `urls`: array of Reddit post URLs - **Proxy Support** - ✅ Built-in proxy support for more reliable scraping during batch runs - **Retry Mechanism** - ✅ Includes resilient execution behavior and fallback handling (implementation details are not exposed) - **Dataset Structure** - ✅ Each input URL is pushed with a top-level object containing `url` and `result` - **Rate Limits & Performance** - ✅ Processing includes a small delay between items (politeness delay) to help stability across batches - **Limitations** - ❌ If the actor cannot extract media from a given Reddit post, it returns an error result with `error: true` and a `message` such as “Failed to extract media” or an exception string. *** ### FAQ #### What does Reddit Media Downloader extract from Reddit posts? ✅ Reddit Media Downloader extracts downloadable media from Reddit posts and returns a structured `result` object including `title`, `thumbnail`, and a `medias` array containing media entries with direct URLs. #### Do I need an account or API key to run it? ✅ You can run the actor directly from **Apify Console** by providing input JSON (including the `urls` array). No API key is required unless you’re calling Apify programmatically. #### Can it download audio as well? ✅ When the post contains audio representations in the extracted media metadata, the actor includes audio entries in `result.medias` (with an audio MP4 URL and `extension` set to `"mp3"` in the returned media item). #### What happens if a post has no extractable media? ❌ If media can’t be extracted, the actor pushes a result object with `error: true` and a `message` (either “Failed to extract media” or an exception string). #### How do I pass multiple Reddit links at once? ✅ Add all the Reddit post URLs you want into the `urls` array in your input JSON. The actor processes each URL and pushes its result item-by-item. #### Is this suitable for “download Reddit videos” at scale? ✅ Yes. The actor is designed for batch runs using a `urls` list, and it saves results as it goes so you can keep working even if individual URLs fail. #### Does Reddit Media Downloader include thumbnails and titles for organization? ✅ Yes. Successful results include `title` and a `thumbnail` URL (when available or derived from preview images). *** ### Support & feature requests Want to improve Reddit Media Downloader? 💬 Share feedback and feature requests—your ideas directly shape the roadmap. - 💡 **Feature Requests**: Examples include CSV export for easier **Reddit MP4 downloader** workflows, expanded handling for additional media types, or extra metadata fields for analytics. - 📧 **Contact**: Reach out at . We’re committed to making Reddit media extraction faster, cleaner, and more useful for your real workflows. 🚀 *** ### Closing CTA / Final thoughts *Reddit Media Downloader* is the most practical, SEO-optimized way to turn public Reddit post media into structured, automation-ready results—perfect for content teams, analysts, and anyone doing large-scale **download reddit videos** work. *** ### Disclaimer **This tool only accesses publicly accessible sources**. It does not access private profiles, authenticated data, or password-protected pages. Any use must comply with applicable laws and platform terms (including GDPR, CCPA, spam regulations, and site-specific Terms of Service). For data removal requests, contact . Please use this actor responsibly, ethically, and for legitimate purposes only. # Actor input Schema ## `urls` (type: `array`): List of Reddit post URLs to scrape. ## Actor input object example ```json { "urls": [ "https://www.reddit.com/r/ChatGPT/comments/1t99m84/the_spaghetti_benchmark/" ] } ``` # 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("solid-scraper/reddit-media-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("solid-scraper/reddit-media-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 solid-scraper/reddit-media-downloader --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=solid-scraper/reddit-media-downloader", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Reddit Media Downloader", "description": "📹 Reddit Media Downloader lets you effortlessly save photos, GIFs, and videos from Reddit in seconds. ⚡ Fast, user-friendly, and efficient—ideal for creators, researchers, and fans who want offline access anytime.", "version": "0.1", "x-build-id": "Aq87xHDAFyICb4c7L" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solid-scraper~reddit-media-downloader/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solid-scraper-reddit-media-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~reddit-media-downloader/runs": { "post": { "operationId": "runs-sync-solid-scraper-reddit-media-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~reddit-media-downloader/run-sync": { "post": { "operationId": "run-sync-solid-scraper-reddit-media-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": [ "urls" ], "properties": { "urls": { "title": "Reddit Post URLs", "type": "array", "description": "List of Reddit post URLs to scrape.", "items": { "type": "string" }, "default": [ "https://www.reddit.com/r/ChatGPT/comments/1t99m84/the_spaghetti_benchmark/" ] } } }, "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 } } } } } } } } } } ```