Reddit Subreddit Scraper

Pricing

Rating

Developer

Actor stats

Categories

Share

Scrape Reddit subreddit posts, subreddit metadata, and optional top-comment previews. This actor is MCP optimized, perfect for SEO and AI agents, and built for social listening, trend discovery, content research, competitor monitoring, and community analysis.

What it extracts

• Subreddit post titles, bodies, authors, scores, upvote ratios, comment counts, flairs, domains, media URLs, permalinks, and timestamps
• Subreddit metadata such as subscriber count, description, NSFW flag, type, icon, and banner
• Optional compact top-comment previews embedded inside each post record
• Source diagnostics so API users and AI agents can see whether data came from Reddit OAuth or a managed provider fallback

Input examples

{
"subreddits":["r/MachineLearning","https://www.reddit.com/r/programming"],
"sort":"top",
"timeRange":"week",
"maxPosts":50,
"includeSubredditInfo":true,
"includeTopComments":false
}

Search inside each subreddit:

{
"subreddits":["r/SEO","r/marketing"],
"query":"AI search",
"sort":"top",
"timeRange":"month",
"maxPosts":100
}

Output shape

The dataset contains recordType: "post" rows for posts and recordType: "subreddit" rows for subreddit metadata. Post rows are intentionally flat and agent-friendly, with optional nested topComments only when you enable comment previews.

Data sources

The actor uses Reddit OAuth when REDDIT_CLIENT_ID and REDDIT_CLIENT_SECRET are configured. If OAuth is unavailable or returns no posts, it falls back to owner-managed ScrapeCreators and SociaVault keys when present. End users can also pass their own Reddit app credentials in the input.

Pricing

• $0.002 per post returned
• $0.010 per subreddit metadata record returned
• Tiny actor-start event for platform usage accounting

Billing stops when maxPosts is reached.

Notes

Reddit may restrict deleted, quarantined, private, banned, or geo-sensitive communities. Empty runs finish successfully with a diagnostic RUN_SUMMARY instead of crashing, which makes the actor safer for scheduled monitors and MCP tool calls.