Reddit Search Media Downloader

Search Reddit and download videos, images, and GIFs from posts, along with comprehensive metadata. This actor is designed for developers and researchers who need to programmatically collect media and data from Reddit searches.

Overview

This actor performs searches on Reddit and extracts media files (videos, images, GIFs) from the resulting posts. It returns direct download links for the media and a full set of metadata for each post, including author, subreddit, and engagement details. No Reddit account or login is required.

Key Features

• Search & Filtering: Search Reddit with configurable sorting (relevance, hot, new, top, comments) and time ranges (hour, day, week, month, year, all). Control NSFW content inclusion.
• Media Extraction: Downloads multiple media types from posts:
  • Videos: Extracts Reddit-hosted videos, often with multiple quality options.
  • Images: Fetches high-resolution images.
  • GIFs: Handles both animated GIFs and video GIFs (v.redd.it).
• Comprehensive Metadata: Each result includes:
  • Post Data: Title, URL, permalink, text, creation timestamp.
  • Subreddit Info: Name, subscriber count, NSFW status.
  • Author Data: Username.
  • Engagement: Score, upvote ratio, number of comments.
  • Media Details: Type, dimensions, duration, thumbnail URLs, and direct download links.
• Performance: Can extract up to 500 posts per search run.

How to Use

Configure the actor using a JSON input. Here are basic examples:

Search for "funny" posts:

{
  "query": "funny",
  "sort": "relevance",
  "time": "all",
  "nsfw": true,
  "maxResults": 50
}

Get top "gaming" posts from the past week:

{
  "query": "gaming highlights",
  "sort": "top",
  "time": "week",
  "nsfw": false,
  "maxResults": 100
}

Input/Output

Input Parameters

Output Format

The actor outputs an array of items, where each item represents a Reddit post. The dataset includes the full metadata and a media array containing the extracted media files.

A typical output item includes fields like:
* id, title, url, permalink, createdAt
* subreddit (name, subscribers, nsfw)
* author (name)
* score, upvoteRatio, numComments
* media: An array of objects with type, url, width, height, and thumbnail links.

The direct download URLs for the media files are provided within the media array for each post.