📌 Reddit Posts Scraper (vulnv/reddit-posts-scraper)

Unlimited Reddit web scraper—extract detailed post and comment data from any subreddit without login. Perfect for sentiment analysis, trend monitoring, social media research, and more.

---

🚀 Features

• Scrape Reddit post titles, authors, creation timestamps, scores (upvotes), comment counts, permalinks, images/thumbnails, post bodies, and comments
• Support for hot, new, top, rising categories
• Time filters for top (hour, day, week, month, year, all)
• Structured JSON output—ideal for automation and data analysis
• Fully programmatic via Apify API, Python, JavaScript, CLI, OpenAPI, MCP
• Built-in support for Apify Proxy to avoid scraping bans

---

💡 Example: Run via Apify API (Python)

from apify_client import ApifyClient

# 1. Install:
# pip install apify-client

# 2. Initialize:
client = ApifyClient("<YOUR_API_TOKEN>")

# 3. Configure input:
run_input = {
    "subreddit_name": "worldnews",
    "limit": 5,
    "category": "top",
    "time_filter": "day",
    "proxy_configuration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"]
    }
}

# 4. Execute actor:
run = client.actor("vulnv/reddit-posts-scraper").call(run_input=run_input)

# 5. Fetch results:
dataset_id = run["defaultDatasetId"]
print(f"Results URL: https://console.apify.com/storage/datasets/{dataset_id}")
for item in client.dataset(dataset_id).iterate_items():
    print(item)

---

🔧 Input Schema

Parameter	Type	Description
subreddit_name	string	Subreddit to scrape (e.g., "worldnews")
limit	integer	Number of posts (1–∞, default 1)
category	string	One of "hot", "new", "top", "rising"
time_filter	string	For "top": hour, day, week, month, year, or all
proxy_configuration	object	{ useApifyProxy: true, apifyProxyGroups: ["RESIDENTIAL"] }

---

🔍 Output Example (JSON)

[
  {
    "title": "Major news event",
    "author": "reddit_user123",
    "created_utc": 1700000000,
    "num_comments": 256,
    "score": 1500,
    "permalink": "https://www.reddit.com/r/worldnews/comments/...",
    "image_url": "...preview.jpg",
    "thumbnail_url": "...thumb.jpg",
    "body": "This is the post content.",
    "comments": [
      { "author": "commenter1", "text": "..." }
    ]
  }
]

---

🎯 Use Cases

• Trend Monitoring: Track hot discussions in real time
• Sentiment Analysis: Analyze opinions via post/comment text
• Media & News Research: Monitor emerging topics in niche subs
• Competitive Intelligence: Observe engagement on competitor mentions
• Academic Research: Automate Reddit data collection for studies
• Marketing: Track brand mentions and community sentiment

---

📡 Programmatic Access & API

• Run via Apify's Python/JavaScript SDK, CLI, or HTTP endpoints (apify.com, apify.com, apify.com)
• Use the MCP server for real-time SSE integration with workflows (apify.com)

---

🧠 Why Choose This Actor?

• ✅ No Reddit login/API token required
• ✅ Handles comments and post bodies
• ✅ Flexible filters: category + time window
• ✅ Supports Residential proxies to avoid blocks
• ✅ Fully SDK & REST compatible via Apify ecosystem

---

📦 Getting Started

1. Create a free account on Apify
2. Enable Apify Proxy (recommended) for stability
3. Run the actor manually or programmatically
4. Export data in JSON, CSV, XML, etc.

---

🔗 Learn More

• Explore the actor on Apify: vulnv/reddit-posts-scraper
• Browse the README, Input, API, and Issues tabs for usage guidance
• Check out the OpenAPI definition and Python example for SDK integration (apify.com, apify.com, apify.com)