# Reddit Media Downloader (`scrapevanta/reddit-media-downloader`) Actor 📺 Reddit Media Downloader makes it easy to download videos, GIFs, and images from Reddit—fast and reliable. 🚀 Save time, curate content, and enjoy offline media anytime. Perfect for creators & researchers! 💾✨ - **URL**: https://apify.com/scrapevanta/reddit-media-downloader.md - **Developed by:** [ScrapeVanta](https://apify.com/scrapevanta) (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 $4.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 🚀 — Extract Videos & Images From Reddit Posts Fast Trying to download Reddit media one post at a time is slow, messy, and easy to get wrong. **Reddit Media Downloader** extracts high-quality videos and images from Reddit posts so you can move from link list to ready-to-use media quickly. You can use it as a Reddit video downloader online, a save reddit video tool, or a reddit image downloader for photos and previews. It’s ideal for marketers, data analysts, and researchers who need reliable bulk downloads from public web data. In one run, you can process multiple Reddit Post URLs and start getting structured media links almost immediately. --- ### See the Data: Sample Output Here's a real record from a single run: ```json { "url": "https://www.reddit.com/r/ChatGPT/comments/1t99m84/the_spaghetti_benchmark/", "result": { "url": "https://v.redd.it/unknown", "source": "reddit", "title": "The Spaghetti Benchmark", "thumbnail": "https://example.com/preview.jpg", "medias": [ { "type": "video", "maxquality": false, "quality": "720p", "url": "https://v.redd.it/unknown/DASH_720.mp4", "info": { "bandwidth": "1500000", "codecs": "avc1.4d401f, mp4a.40.2", "frameRate": "30", "height": "720", "id": "720", "mimeType": "video/mp4", "width": "1280" }, "extension": "mp4" } ], "type": "multiple", "error": false, "time_end": 1456 } } ```` If media extraction fails for a link, you’ll receive an error record like this: ```json { "url": "https://www.reddit.com/r/some_subreddit/comments/xxxxxx/some_post/", "result": { "error": true, "message": "Failed to extract media" } } ``` | Field | Type | What It Tells You | |---|---|---| | `url` | string | The input Reddit post URL that was processed. | | `result` | object | The extracted payload for that post URL (media + metadata) or an error object. | | `result.url` | string | A direct media base URL pointing to the video host for the post. | | `result.source` | string | Indicates the data source as `reddit`. | | `result.title` | string | Post title, useful for naming files or organizing downloads. | | `result.thumbnail` | string | Thumbnail URL (or a derived preview URL when the default thumbnail isn’t usable). | | `result.medias` | array | A list of extracted media items (videos/audio variants) with URLs. | | `result.type` | string | Indicates the overall extraction type (e.g. `multiple`). | | `result.error` | boolean | Flags whether the extraction succeeded (`false`) or not. | | `result.time_end` | number | A value included in the original extraction output. | | `result.type` (media item) | string | Each media item’s `type` (e.g. `video`, `audio`). | | `result.medias[].quality` | string | The quality label for video renditions (e.g. `720p`) or `audio` for audio items. | | `result.medias[].url` | string | The direct downloadable media URL. | | `result.medias[].extension` | string | File extension for the media item (e.g. `mp4`). | | `result.medias[].info` | object | Technical metadata for the media item (bandwidth, codecs, width/height, etc.). | | `result.error` / `result.message` | boolean/string | Error handling fields returned when a post can’t be processed (e.g. “Failed to extract media”). | 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 { "urls": [ "https://www.reddit.com/r/ChatGPT/comments/1t99m84/the_spaghetti_benchmark/" ] } ``` | Parameter | Required | What It Does | |---|---:|---| | `urls` | ✅ | Provide a list of Reddit post URLs to scrape and extract media from. | *** ### What It Does Reddit Media Downloader pulls structured media links and metadata from Reddit post URLs you provide. #### Bulk extraction from Reddit post URLs You pass a list of post links in `urls`, and the actor processes each one and returns a structured `result` object. This makes it a practical Reddit media grabber when you’re handling more than a couple posts. #### Extracts video renditions and audio variants For posts that include video content, it extracts media items into `medias`, including video renditions (with `quality`) and audio items (with `quality: "audio"`). The direct downloadable URLs are included as `url` for each media item. #### Clean, structured output for downstream use Every processed record includes the original post `url`, plus a `result` object that contains `title`, `thumbnail`, and a `medias` array. That structure is designed to plug into workflows for saving reddit video, download reddit photos (where a thumbnail preview is available), and organizing assets in spreadsheets. #### Built-in error handling per link If a post can’t be decoded into usable media, the actor still returns a record with `result.error` and a `result.message` (for example, “Failed to extract media”). This helps you keep runs moving and review failures without losing progress. #### Uses your URLs to produce media-ready links (not just metadata) The output includes direct media URLs inside `medias[].url`, so you’re not stuck manually copying sources after the scrape. That’s what makes it useful as a reddit mp4 downloader or reddit to mp4 converter workflow starter. Overall, Reddit Media Downloader turns a list of Reddit links into structured media assets in one run—ideal when you need speed without manual clicking. *** ### Why Reddit Media Downloader? There are plenty of ways to pull data from Reddit—here’s why Reddit Media Downloader stands out. #### Output is directly usable Instead of only listing post details, it returns media items with direct `url` and `extension` values inside `medias`. That makes it a strong fit for anyone building a Reddit video downloader online workflow or automating save reddit video tasks. #### Designed for multi-link runs You can submit many post URLs in one input (`urls`) and get a corresponding dataset of results. This reduces the effort of running post-by-post processes when you’re downloading reddit media at scale. #### Built with practical resilience The actor includes per-link error handling so you can see which URLs succeeded and which failed without derailing the entire run. That helps keep research pipelines and marketing asset workflows moving even when some posts don’t contain downloadable video content. *** ### Real-World Use Cases **Content Marketing Teams**\ A campaign manager has a shortlist of Reddit threads and needs to pull the actual media to repurpose into ads, landing pages, or social posts. They run Reddit Media Downloader with the post URLs, then use the returned `title`, `thumbnail`, and `medias[].url` values to organize downloads and speeds up creating multiple variants for review. **Research Analysts**\ A researcher is collecting examples of multimedia posts across topics and wants a consistent dataset. They run Reddit Media Downloader to capture structured results (including `thumbnail` and the `medias` list) so every case has comparable metadata and media links for documentation. **Sales Enablement & Creative Ops**\ A creative operations specialist needs Reddit stories, reels, or clips for internal enablement materials and wants to avoid manual downloading. They feed in a batch of Reddit post links, then use the output to quickly grab the video/audio renditions and distribute them to the team. **Automation & Data Pipeline Builders**\ A developer wants repeatable ingestion into a data warehouse or asset manager. They trigger Reddit Media Downloader via the Apify run, then store `result.title`, `result.medias[].url`, and related metadata in their pipeline for later download and processing—no manual copying required. **Community Moderation & QA Workflows**\ A team running audits on public posts needs quick access to what was actually uploaded (video renditions and previews). They run Reddit Media Downloader across the URLs to verify content availability and keep an audit trail with thumbnails and media URLs. *** ### 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 at [console.apify.com](https://console.apify.com) and find **Reddit Media Downloader**. 2. **Enter your inputs**\ Paste your Reddit post URLs into the `urls` field in `input.json`. 3. **Configure proxy settings (optional, if available in your run UI)**\ If you’re using proxy configuration in the Apify interface, set it according to your reliability needs. 4. **Start the run and watch the live log**\ Launch the actor and monitor progress while it processes each input URL. 5. **Open the Dataset tab to see live results**\ As each post finishes, you’ll get records containing `url` and `result` with `title`, `thumbnail`, and `medias`. 6. **Export in your preferred format**\ Download the dataset 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, Reddit Media Downloader fits directly into your existing workflow. Export formats are available from the Apify dataset tab, including JSON, CSV, and Excel. From there, you can import into spreadsheets, CRMs, or media management tools. For automation, you can use Apify’s API access to pull results programmatically, connect via no-code tools like Zapier/Make for pushing to other systems, and set up downstream steps (for example, downloading files) after the run completes via webhooks. For deeper details, check the Apify documentation for each integration method. *** ### Pricing Reddit Media Downloader runs on Apify, which includes a **free tier** — no credit card needed to start. You’ll typically start with free platform credits on sign-up, enough for several real test runs. After that, runs are billed per Actor compute unit (CU) with pay-as-you-go scaling—so you’re not locked into a monthly commitment. Start free at [apify.com](https://apify.com) — scale up when you need to. *** ### Reliability & Limitations | What We Handle | How | |---|---| | Rate-limit resilience | Built to work smoothly across batches with controlled pacing. | | Per-link failure handling | Returns `result.error` and a `result.message` for links that can’t be processed. | | Output consistency | Media results include `title`, `thumbnail`, and `medias` in a structured format. | | Media parsing variability | If media isn’t available in the expected structure, you’ll see an error message instead of silent failure. | Limitations: this actor works on publicly accessible post content and only extracts media when the post includes downloadable video content structured in a compatible way. Posts without usable media for extraction will return an error object for that URL. If you need special handling for edge cases, reach out for help. 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, so you can run Reddit Media Downloader for testing without a credit card. Availability and included credits depend on your Apify account and current plan. #### Do I need to log in or create an account on Reddit? No. This actor is intended to work with publicly accessible Reddit content using the URLs you provide. #### How accurate is the extracted data? The actor extracts what it can from the provided Reddit post content and returns structured `result` data (including `title`, `thumbnail`, and media URLs in `medias`). If a post doesn’t contain usable downloadable media in the expected structure, you’ll get an error message for that URL. #### How many results can I get per run? You can provide multiple Reddit post URLs in the `urls` array, and the actor returns one dataset record per input URL. The practical limit depends on your run configuration and Apify plan limits. #### How fresh is the data? It’s as fresh as the moment your run requests the post content. If a post changes or media becomes unavailable, results for later runs may differ. #### Is this legal? Does it comply with GDPR / CCPA? The actor processes publicly available data from the URLs you supply. You’re responsible for using the output lawfully and in compliance with GDPR, CCPA, and applicable platform terms. #### Can I export to Google Sheets or Excel? Yes. You can export your dataset from the Apify dashboard as JSON, CSV, or Excel and then import it into Google Sheets or other tools. This is also compatible with automation workflows using APIs. #### Can I schedule this to run automatically? Yes. You can schedule Apify actor runs (via Apify scheduling features) to refresh datasets on a recurring basis, depending on your use case. #### Can I access results via the API? Yes. You can retrieve results programmatically using the Apify API after the run completes. This is useful for automation pipelines that ingest reddit media grabber outputs into your systems. #### What happens when the actor encounters an error? Errors are handled per URL. For failures, the actor still pushes a dataset record where `result.error` is `true` and `result.message` describes what went wrong (for example, “Failed to extract media”). *** ### Get Help & Use Responsibly Got a question about Reddit Media Downloader or a feature you'd like added? Reach out at . We actively maintain this actor based on user feedback and can help with practical run setup and workflow suggestions. *** **Publicly available data only:** Reddit Media Downloader is designed to work with **publicly available data** from Reddit Post URLs you provide. It does not access private accounts, login-gated pages, or password-protected content. You are responsible for GDPR, CCPA, and any platform ToS requirements when collecting, storing, or using the results. For data removal requests, contact . Use responsibly, ethically, and only for lawful purposes. # 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("scrapevanta/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("scrapevanta/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 scrapevanta/reddit-media-downloader --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=scrapevanta/reddit-media-downloader", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Reddit Media Downloader", "description": "📺 Reddit Media Downloader makes it easy to download videos, GIFs, and images from Reddit—fast and reliable. 🚀 Save time, curate content, and enjoy offline media anytime. Perfect for creators & researchers! 💾✨", "version": "0.1", "x-build-id": "KicfCDDeR5pv7cX9c" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapevanta~reddit-media-downloader/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapevanta-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/scrapevanta~reddit-media-downloader/runs": { "post": { "operationId": "runs-sync-scrapevanta-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/scrapevanta~reddit-media-downloader/run-sync": { "post": { "operationId": "run-sync-scrapevanta-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 } } } } } } } } } } ```