Reddit Media Search Scraper

Scrapes Reddit search results specifically for posts containing images or videos. It extracts the media files along with comprehensive post metadata, handling pagination automatically.

Key Features

• Media-Focused Search: Searches across all subreddits for posts containing images or videos.
• Multi-Quality Video Support: Downloads videos in multiple resolutions (220p, 240p, 360p, 480p, 720p).
• Rich Metadata: Extracts post details (title, score, timestamps), author info, subreddit data, and engagement metrics.
• Structured Output: Returns consistent, well-organized data for easy processing.

How to Use

Configure the actor using an input object. The main required parameter is the search query.

Input Configuration

Here’s the basic input structure. Only the query field is mandatory.

{
  "query": "ai",
  "sort": "relevance",
  "time": "all",
  "safeSearch": "0",
  "maxItems": 45
}

• query (string, required): Your search term (e.g., "ai", "memes").
• sort (string): Sort results by relevance, hot, top, new, or comments. Default is relevance.
• time (string): Filter top posts by time: hour, day, week, month, year, all. Default is all.
• safeSearch (string): "0" for standard search, "1" to filter NSFW content. Default is "0".
• maxItems (integer): The maximum number of posts to scrape. Default is 100.

Input/Output

Output Data Structure

Results are saved to the dataset in your Apify storage. Each item is a post object containing:

• Post Info: post_id, title, created_timestamp, score, comment_count, url, flags for nsfw/spoiler.
• Context: subreddit object (id, name), author object (id), position in search results.
• Media Data: media_type ("image" or "video") and a media object.
  • For images: media.src (URL) and media.alt.
  • For videos: media.poster (thumbnail URL), media.duration, and media.sources - an array of video files at different qualities (220p to 720p).

Output Example

[
  {
    "post_id": "t3_1epeshq",
    "title": "These are all AI",
    "created_timestamp": "2024-08-11T07:12:08.989Z",
    "score": 23117,
    "comment_count": 3483,
    "nsfw": false,
    "spoiler": false,
    "url": "https://www.reddit.com/r/ChatGPT/comments/1epeshq/these_are_all_ai/",
    "subreddit": { "id": "t5_7hqomg", "name": "ChatGPT", "nsfw": false },
    "author": { "id": "t2_rpv4m" },
    "position": 0,
    "media_type": "image",
    "media": {
      "src": "https://preview.redd.it/these-are-all-ai-v0-o95bc7fqizhd1.png?...",
      "alt": "r/ChatGPT - These are all AI"
    }
  }
]

Data can be downloaded as JSON, JSONL, CSV, Excel, HTML, or XML from the Storage tab.

Related Actors

• Reddit Posts Search Scraper - Scrapes general Reddit post search results (not media-specific).
• Reddit Comments Scraper - Extracts comment threads and replies.