Reddit Keyword Post Scraper 🧠

Overview

This Actor allows you to scrape Reddit posts based on keywords, date ranges, and sorting options, providing detailed structured data from public subreddit content. Whether you're tracking sentiment in gaming communities or monitoring discussions in niche topics, this tool is designed to streamline your data collection process.

Why choose this actor? 🚀

• Fully configurable via keywords, dates, and sorting
• Collects all visible metadata, comments, and related posts
• NO PROXY REQUIRED — avoids complexity and cost
• Ideal for quick insights or powering downstream ML pipelines
• Free to use up to 10 results — perfect for validation

⚠️ MAX RESULTS MUST BE A MULTIPLE OF 10
⚠️ FREE USERS CAN ACCESS ONLY THE FIRST 10 RESULTS

Use Cases

• Market research and trend analysis across Reddit
• Game developer sentiment tracking (e.g., Battlefield 2042)
• Academic research on Reddit discussions
• Competitive analysis for product mentions

Key Features ⭐

• Retrieves top-level post metadata
• Includes full thread comments with replies
• Fetches all related Reddit post links
• Handles multimedia content (videos, images)
• Compatible with Apify dataset output
• Works even on large subreddits like r/datascience

How It Works 🔍

You define the keywords, date range, and sort order (e.g., 'Hot', 'Top').
The Actor queries Reddit’s search endpoint and parses results including:

• Posts (with full text and links)
• Comments and replies
• Related post suggestions
• Video or photo media
• Subreddit metadata

All results are returned in structured JSON format.

Input Parameters

Field	Type	Description	Example
keywords	array	List of keywords to search on Reddit	["datascience", "cats"]
date	string	Filter posts by time	"Past week"
sort_by	string	Sorting order of posts	"Top"
num_of_posts	integer	Number of posts to fetch per keyword (MAX 40)	10

Output (Full Example)

{
  "post_id": "t3_abc123",
  "url": "https://www.reddit.com/r/example/comments/abc123/example_post/",
  "user_posted": "example_user",
  "title": "Example Post Title",
  "description": "This is an example post used to demonstrate the output.",
  "num_comments": 42,
  "num_upvotes": 123,
  "date_posted": "2025-07-14T16:31:21.000Z",
  "community_name": "example",
  "community_url": "https://www.reddit.com/r/example/",
  "community_description": "Example subreddit description.",
  "community_members_num": 100000,
  "community_rank": {
    "community_rank_type": null,
    "community_rank_value": null
  },
  "tag": "Discussion",
  "photos": null,
  "videos": [
    "https://video.url/video1.mp4",
    "https://video.url/video2.mp4"
  ],
  "related_posts": [
    {
      "community": "example",
      "community_url": "https://www.reddit.com/r/example/comments/related1/",
      "title": "Related Post 1",
      "url": "https://www.reddit.com/r/example/comments/related1/",
      "thumbnail": null,
      "num_upvotes": "47",
      "num_comments": 7
    }
  ],
  "comments": [
    {
      "comment": "Great post!",
      "url": "https://www.reddit.com/r/example/comments/abc123/comment1/",
      "user_commenting": "comment_user",
      "user_url": "https://www.reddit.com/user/comment_user/",
      "date_of_comment": "2025-07-14T20:29:53.000Z",
      "num_upvotes": 2,
      "num_replies": 1,
      "replies": [
        {
          "user_replying": "example_user",
          "user_url": "https://www.reddit.com/user/example_user/",
          "reply": "Thanks!",
          "date_of_reply": "2025-07-14T20:45:23.000Z",
          "num_replies": 0,
          "num_upvotes": 1
        }
      ]
    }
  ],
  "post_karma": 0,
  "bio_description": null,
  "embedded_links": null,
  "timestamp": "2025-07-14T20:53:46.000Z",
  "input": {
    "url": "https://www.reddit.com/r/example/comments/abc123/example_post/"
  },
  "discovery_input": {
    "keyword": "example",
    "date": "Past week",
    "sort_by": "Hot"
  }
}

Pricing

• Free tier: Up to 10 results
• Paid tier: $2/1000 results

Legal Disclaimer

This Actor is intended for lawful use only. Users are responsible for complying with Reddit's Terms of Service.
Apify and the developer assume no liability for misuse of the data collected.

Update Policy

We monitor Reddit’s structure and will update the Actor accordingly if significant changes break functionality.
For urgent fixes, users can submit requests via the Apify console.

FAQ

Does this use proxies?
No, this Actor does not require proxies. ✅

What happens if I input max_results = 35?
The Actor will round it up to 40. MUST BE A MULTIPLE OF 10

How many results can I get for free?
Up to 10 results per keyword are included for free accounts.