---

✨ Reddit Post Media Downloader

---

The Reddit Post Media Downloader is a focused Apify actor for downloading media from any Reddit post. Paste Reddit post URLs and get direct download links for videos, images, galleries, and external embeds. The Reddit Post Media Downloader accepts both subreddit posts (r/) and profile posts (u/) — every URL is processed automatically.

What Is the Reddit Post Media Downloader?

The Reddit Post Media Downloader is a media-focused extraction tool that takes individual Reddit post URLs and returns:

• Direct download URLs — MP4 video, full-resolution images, gallery items, audio streams
• All quality formats — every available resolution, codec, and bitrate option for video posts
• Audio stream URLs — Reddit stores video and audio separately; this actor extracts both
• Gallery/carousel items — each image, video, or GIF in a carousel extracted individually
• External embed data — YouTube, Vimeo, and other oembed providers with embed URLs and thumbnails
• Essential post metadata — post type, title, author, subreddit, score, and media-related fields only

The Reddit Post Media Downloader processes each URL through 6 parallel extraction engines for maximum reliability.

---

What This Actor Does

• Downloads media metadata and URLs from individual Reddit post URLs
• Processes both subreddit posts (r/) and profile posts (u/)
• Extracts video, image, gallery, external embed, and promoted post media
• Returns lightweight post summaries with media-focused fields only
• No comments, no full metadata dump — just download-ready media data

What This Actor Does NOT Do

The Reddit Post Media Downloader does not:

• Scrape entire subreddits or user profiles
• Include comments in output
• Download the actual media files — it provides direct download URLs
• Return full 60+ field post metadata (see the main Metadata Scraper actor for that)

---

Supported Post Types

The Reddit Post Media Downloader handles all Reddit post types:

Post Type	Media Output
Video Posts	Direct MP4 download URL, separate audio stream, DASH/HLS manifests, all quality formats
Image Posts	Full-resolution image URL, all resolution variants
Gallery/Carousel	Individual download link per gallery item (image, video, or GIF)
Text Posts	Post summary only (no media to download)
External Links	External embed URL, oembed metadata, thumbnail, provider info
Rich Video	External video embed URL, iframe HTML, provider name
Promoted/Ad Posts	Media URLs plus call-to-action, destination URL
Mixed Carousels	Each item extracted separately with correct media type

---

Input

Provide one or more Reddit post URLs. Both subreddit and profile post URLs are accepted:

https://www.reddit.com/r/subreddit/comments/postid/
https://www.reddit.com/user/username/comments/postid/
https://v.redd.it/videoid

Input Parameters

Parameter	Type	Default	Description
post_urls	Array	required	Reddit post URLs to download media from
max_results	Integer	0	Max media items to return. 0 = unlimited

Example Input

{
  "post_urls": [
    { "url": "https://www.reddit.com/r/Damnthatsinteresting/comments/1sa33fi/" },
    { "url": "https://www.reddit.com/r/Wellthatsucks/comments/1s9q97r/" },
    { "url": "https://www.reddit.com/r/Weird/comments/1s9s2iw/" },
    { "url": "https://www.reddit.com/user/DimraethDev/comments/1p6ubo6/" },
    { "url": "https://www.reddit.com/user/DavidFromNeo/comments/1rj3crp/" }
  ],
  "max_results": 0
}

---

Output Structure

The Reddit Post Media Downloader produces two record types, each tagged with _item_type.

Media Record (_item_type: "media")

The primary output — one record per downloadable media element:

Field	Type	Description
download_url	string	Best quality direct download URL
audio_url	string	Separate audio stream URL (Reddit videos)
media_type	string	video, image, gif, gallery, rich_video
source_url	string	Original source URL
thumbnail_url	string	Thumbnail URL
width	integer	Width in pixels
height	integer	Height in pixels
duration	float	Duration in seconds (video)
file_size	integer	File size in bytes
ext	string	File extension (mp4, jpeg, png)
title	string	Media/post title
media_id	string	Unique media ID
uploader	string	Post author
subreddit	string	Subreddit name
reddit_post_url	string	Source Reddit post URL
post_score	integer	Post score
num_comments	integer	Comment count
post_created_at	string	Post creation time
flair	string	Post flair
is_reddit_hosted	boolean	True = Reddit-hosted, False = external
embed_url	string	External embed URL
provider_name	string	External provider (YouTube, Vimeo)
oembed_title	string	Embedded content title
oembed_author	string	Embedded content author
all_formats	array	All available quality options with URLs, codecs, bitrates

Post Summary Record (_item_type: "post")

Lightweight context about each processed post:

Field	Type	Description
post_id	string	Reddit post ID
title	string	Post title
post_type	string	video, image, gallery, text, link, rich_video, ad
author	string	Post author
subreddit	string	Subreddit name
permalink	string	Full Reddit permalink
url	string	Target URL
media_url	string	Media destination URL
domain	string	Content domain
score	integer	Net upvotes
upvote_ratio	float	Upvote ratio
num_comments	integer	Comment count
created_at	string	ISO-8601 creation time
is_video	boolean	Video post flag
is_gallery	boolean	Gallery post flag
over_18	boolean	NSFW flag
flair	string	Post flair
thumbnail	string	Thumbnail URL
is_promoted	boolean	Promoted post flag
is_ad	boolean	Ad post flag
video_info	object	Video details (fallback URL, dimensions, duration)
gallery_items	array	Gallery items with URLs and dimensions
preview_images	array	Preview images at all resolutions
oembed	object	External embed metadata

---

Video Download Example

{
  "_item_type": "media",
  "download_url": "https://v.redd.it/93jz90kreosg1/CMAF_720.mp4?source=fallback",
  "audio_url": "https://v.redd.it/93jz90kreosg1/DASH_audio.mp4",
  "media_type": "video",
  "width": 1280,
  "height": 720,
  "duration": 123.0,
  "title": "History has been made as NASA has successfully launched Artemis II",
  "all_formats": [
    { "label": "fallback", "url": "...", "type": "mp4/video" },
    { "label": "dash", "url": "...", "type": "dash" },
    { "label": "hls", "url": "...", "type": "hls" },
    { "label": "audio", "url": "...", "type": "mp4/audio" }
  ]
}

---

Gallery/Carousel Example

For a post with 5 images, the Reddit Post Media Downloader returns 5 separate media records:

{
  "_item_type": "media",
  "download_url": "https://preview.redd.it/abc123.jpeg",
  "media_type": "image",
  "width": 4284,
  "height": 5712,
  "ext": "jpeg"
}

---

Limitations

• Extracts download URLs and metadata — does not download actual files
• Reddit rate limits apply to large batches
• Deleted or removed posts may return partial data
• Private subreddit/profile posts cannot be accessed

---

Privacy & Compliance

The Reddit Post Media Downloader only accesses publicly available data through Reddit's public API endpoints. No login credentials are used. Ensure your use complies with Reddit's Terms of Service and applicable privacy regulations.