Reddit Media Downloader

Download Reddit-hosted images, galleries, GIFs, and video streams from public Reddit post URLs. This actor resolves the Reddit post metadata, extracts every supported media asset, optionally saves the files to the run key-value store, and returns one clean dataset row per media item.

It is built for content archives, research collections, moderation workflows, social listening, AI-agent pipelines, and no-code automations that need files, not just Reddit post text.

What It Extracts

Field	Description
mediaUrl	Direct Reddit or Reddit CDN media URL.
fileKey and fileApiUrl	Key-value store location when file saving is enabled.
audioUrl and audioFileApiUrl	Separate v.redd.it audio stream when Reddit exposes one.
mediaType	image, gif, video, audio, or manifest.
title, subreddit, author, score	Useful Reddit post metadata for sorting and attribution.
dashUrl, hlsUrl	Video manifest URLs for advanced processing.
downloadStatus	Tells you whether the file was saved, skipped, too large, or unavailable.

When To Use

Use this actor when you have one or more public Reddit post URLs and need the media assets behind those posts. It is especially useful for Reddit video archiving because Reddit often separates the video stream and audio stream. The actor records both so downstream tools can merge, transcode, or store them.

Use a broader Reddit scraper when you need search results, subreddit feeds, comments, or user profile data. This actor starts from known post URLs and focuses on media extraction and download storage.

Input

{
  "urls": [
    "https://www.reddit.com/r/ChatGPT/comments/1iic23b/who_said_ai_videos_cant_do_physics/"
  ],
  "maxMediaItems": 25,
  "downloadMedia": true,
  "downloadAudio": true,
  "maxFileSizeMb": 250,
  "includeVideoVariants": true,
  "includeNsfw": false
}

urls accepts full Reddit post URLs. The actor soft-skips invalid, private, deleted, or unsupported URLs and records the reason in OUTPUT.

downloadMedia controls whether binary files are saved to the default key-value store. Turn it off when you only need direct source URLs and metadata.

maxFileSizeMb protects storage and runtime cost. Oversized files still produce metadata rows with downloadStatus set to skipped_too_large.

Output Example

{
  "recordType": "media",
  "sourceUrl": "https://www.reddit.com/r/example/comments/abc123/example/",
  "canonicalPostUrl": "https://www.reddit.com/r/example/comments/abc123/example/",
  "postId": "abc123",
  "subreddit": "r/example",
  "title": "Example Reddit video",
  "mediaType": "video",
  "mediaUrl": "https://v.redd.it/example/DASH_720.mp4",
  "audioUrl": "https://v.redd.it/example/DASH_audio.mp4",
  "downloadStatus": "saved",
  "fileKey": "MEDIA_abc123_000_media.mp4",
  "fileApiUrl": "https://api.apify.com/v2/key-value-stores/.../records/MEDIA_abc123_000_media.mp4",
  "audioDownloadStatus": "saved",
  "audioFileKey": "MEDIA_abc123_000_audio.mp4",
  "assetIndex": 0,
  "assetCount": 1,
  "provider": "reddit-oauth",
  "scrapedAt": "2026-07-08T00:00:00.000Z"
}

Metadata Sources

The actor tries metadata resolvers in this order:

1. Reddit OAuth using REDDIT_CLIENT_ID and REDDIT_CLIENT_SECRET.
2. ScrapeCreators using SCRAPECREATORS_API_KEY.
3. SociaVault using SOCIAVAULT_API_KEY.

The media files themselves are downloaded directly from Reddit-hosted media URLs such as i.redd.it, preview.redd.it, and v.redd.it. If no resolver is configured, the actor exits successfully with a warning and a machine-readable summary instead of marking the run as failed.

Pricing

This actor uses pay per event pricing.

Event	Price
Actor start	$0.00005
Media extracted	$0.005 per media row

The run status message shows the maximum possible cost before extraction starts. maxMediaItems is a hard billing cap.

Limits

Reddit-hosted media is supported. External hosts such as Imgur, YouTube, TikTok, or news sites are not downloaded by this actor. Posts that are private, deleted, removed, login-gated, or blocked by Reddit may not resolve.

Reddit video and audio are usually separate files. This actor saves both when available, but it does not merge or transcode them. Use ffmpeg or a media pipeline downstream if you need a single combined MP4.

API Example

apify call khadinakbar/reddit-media-downloader --input='{
  "urls": ["https://www.reddit.com/r/ChatGPT/comments/1iic23b/who_said_ai_videos_cant_do_physics/"],
  "maxMediaItems": 10,
  "downloadMedia": true
}'

Legal And Responsible Use

Download only content you are allowed to use. Respect Reddit users, subreddit rules, copyright, privacy rights, platform terms, and applicable laws. This actor provides technical extraction of public media URLs and files; you are responsible for how the downloaded media is stored, shared, edited, or reused.