🎬 Reddit Video Downloader & Search (With Audio)

The only Reddit scraper that downloads videos WITH SOUND. Search by keywords, filter by upvotes, duration, and aspect ratio — get ready-to-post MP4 files for TikTok, Reels, and YouTube Shorts.

---

❓ Why Use This Actor?

Other Reddit Downloaders	This Actor
❌ Require you to paste URLs manually	✅ Searches Reddit automatically by keywords
❌ Download silent videos (no audio)	✅ Full audio included — FFmpeg merges DASH streams
❌ Download everything (images, text, garbage)	✅ Smart filtering — only videos that match your criteria
❌ No control over video format	✅ Aspect ratio filter — vertical (9:16) for TikTok/Reels
❌ No metadata	✅ Rich metadata export — upvotes, comments, author, date

🔊 The Audio Problem (Solved)

Reddit stores video and audio as separate streams (DASH format). Most scrapers download only the video track — leaving you with a silent, useless file.

Our solution: We run FFmpeg inside the Apify container to:

1. Download the video stream
2. Download the audio stream
3. Merge them into a single MP4 file
4. Deliver a ready-to-use video with full sound

---

✨ Features

🔍 Search & Discovery

• Keyword Search — Enter topics like "funny cats", "crypto news", "gaming fails"
• Subreddit Mode — Scrape specific subreddits (r/videos, r/TikTokCringe, etc.)
• Sorting Options — Top (All Time / Year / Month / Week / Day), Hot, New

🎯 Smart Filtering

• Minimum Upvotes — Only viral content (e.g., 1000+ upvotes)
• Duration Range — Set min/max length (perfect for 15-60 sec TikTok clips)
• Aspect Ratio — Vertical (9:16), Horizontal (16:9), or Any
• NSFW Filter — Include or exclude adult content
• Goal & Limit System — "Find 10 videos, but scan no more than 500 posts"

📦 Output & Export

• MP4 with Audio — Ready for upload to any platform
• Thumbnail Download — Cover images for each video
• Rich Metadata — JSON/CSV/Excel with all post information

---

🚀 Quick Start (Step-by-Step)

1. Input Keywords: Enter what you want to find (e.g., funny cats) in the Search Keywords field.
2. Set Limits: Choose how many videos to download (e.g., 10) and how deep to scan (e.g., 200 posts).
3. Run: Click the Start button.
4. Download: Once finished, go to the Dataset tab to download your results in JSON/Excel, and click the links to download MP4 files.

---

⚙️ Input Parameters

Parameter	Type	Description	Example
searchKeywords	String	Keywords to search on Reddit	"funny cats"
subreddits	Array	List of subreddits to scrape	["videos", "TikTokCringe"]
sort	Enum	Sorting method	"top", "hot", "new"
maxVideos	Number	How many videos you want	10
maxPostsToScan	Number	Maximum posts to check	500
minUpvotes	Number	Minimum upvote threshold	1000
minDuration	Number	Minimum video length (seconds)	15
maxDuration	Number	Maximum video length (seconds)	60
aspectRatio	Enum	Video orientation	"vertical", "horizontal", "any"
includeNSFW	Boolean	Include adult content	false
downloadThumbnails	Boolean	Also download cover images	true

---

📤 Output Example (JSON)

Each result contains metadata and a direct link to the downloaded MP4 file in the Key-Value Store.

{
  "title": "My cat doing a backflip",
  "subreddit": "r/cats",
  "postUrl": "https://www.reddit.com/r/cats/comments/12345/backflip/",
  "upvotes": 15420,
  "duration": 12,
  "aspectRatio": "vertical",
  "isNSFW": false,
  "videoFileUrl": "https://api.apify.com/v2/key-value-stores/STORE_ID/records/r_cats_backflip.mp4",
  "thumbnailFileUrl": "https://api.apify.com/v2/key-value-stores/STORE_ID/records/r_cats_backflip_thumb.jpg",
  "scrapedAt": "2024-03-20T10:00:00.000Z"
}

---

👥 Use Cases

🎵 TikTok / Reels / Shorts Creators

Set aspectRatio: "vertical", minUpvotes: 10000, minDuration: 15. Result: A folder of viral vertical videos ready to be reposted.

📺 YouTube Compilation Channels

Set subreddits: ["PublicFreakout"], maxVideos: 50. Result: 50 clips with sound for your next "Best of" compilation.

🏢 Brand Monitoring

Search by brand name keywords. Get video evidence with full metadata (who posted, when, how many views) for your reports.

---

🧑‍💻 Integrations (API)

You can run this actor programmatically to build your own automated pipelines using the Apify Client.

Python Example

from apify_client import ApifyClient

client = ApifyClient("YOUR_API_TOKEN")

run_input = {
    "searchKeywords": ["satisfying video"],
    "maxVideos": 5,
    "aspectRatio": "vertical",
    "proxyConfiguration": { "useApifyProxy": True }
}

run = client.actor("eondev/reddit-video-downloader-search-audio").call(run_input=run_input)

# Get results
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(f"Downloaded: {item['title']} -> {item['videoFileUrl']}")

Node.js Example

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_API_TOKEN' });

const input = {
    subreddits: ['PublicFreakout'],
    maxVideos: 10,
    minUpvotes: 1000
};

const run = await client.actor("eondev/reddit-video-downloader-search-audio").call(input);
console.log(`Fetch results from dataset: ${run.defaultDatasetId}`);

---

💡 Tips

• Save Money: Use the minUpvotes filter! Don't waste compute units downloading videos with 0 likes.
• Speed Up: If you just need data analysis, turn off downloadThumbnails.

---

Made with ❤️ for content creators and automation enthusiasts.