Reddit Scraper

Scrape Reddit posts, comments, and subreddits — titles, scores, upvote ratios, media, awards, flair, and top comments.

What you get

Structured Reddit data from global search or specific subreddits. Pull posts with full engagement stats, optionally fetch top comments, and browse subreddit listings. Supports Reddit's native sort orders and time filters.

Output fields

Field	Description
title	Post title
author	Post author
subreddit	Subreddit name
url	External URL (link posts)
permalink	Reddit post URL
selftext	Post body text (self posts)
score	Net upvotes
upvoteRatio	Upvote percentage
numComments	Comment count
created	ISO 8601 post timestamp
isNSFW	NSFW flag
mediaUrl	Image or video URL
awards	Awards received
flair	Post flair
topComments	Array of top comments (when includeComments is on)

Example output

{
    "title": "I built a web scraper that...",
    "author": "username123",
    "subreddit": "programming",
    "url": "https://example.com/article",
    "permalink": "https://www.reddit.com/r/programming/comments/1jx3abc/...",
    "selftext": "Full post body text here...",
    "score": 1542,
    "upvoteRatio": 0.95,
    "numComments": 87,
    "created": "2026-04-10T14:30:00+00:00",
    "isNSFW": false,
    "flair": "Discussion"
}

Input parameters

Parameter	Required	Description
queries	Yes	List of search terms or subreddit names. Prefix with r/ for subreddits (e.g., r/python), or use plain keywords for global search. Example: ["r/programming", "python async", "r/datascience"].
searchType	No	posts searches for posts, subreddits browses subreddit listings. Default posts.
sort	No	Sort order: hot, new, top, rising, or relevance. Default hot.
timeFilter	No	Time range for top and relevance sort: hour, day, week, month, year, all. Default all.
maxResults	No	Max posts per query, up to 1,000. Default 8.
includeComments	No	Fetch top-level comments for each post. Adds ~2 s per post. Default false.

Use cases

• Market researchers: Track brand and product mentions across subreddits.
• Content teams: Find trending topics and recurring questions to turn into content.
• Community managers: Monitor subreddit activity, growth, and top posts.
• Product teams: Collect user feedback, bug reports, and feature requests from r/yourproduct.
• Academics: Study online discourse, sentiment, and community behavior.

Pricing

Pay-per-result pricing. Tiered discounts apply automatically based on usage volume.

Tier	Price per result
FREE	$0.006
BRONZE	$0.005
SILVER	$0.004
GOLD	$0.003

Limitations

• Up to 1,000 results per query (Reddit's own pagination cap).
• Private and quarantined subreddits are not accessible.
• Enabling includeComments meaningfully extends run time — use it only when you need comment bodies.
• Removed or deleted posts appear with empty selftext and [removed]/[deleted] authors.

Compared to alternatives

• vs. trudax/reddit-scraper (paid monthly): This actor uses pay-per-result, so short test runs cost cents instead of a monthly minimum. Native Reddit sort orders and time filters are exposed 1:1.

Pairs well with Twitter/X Profile Scraper and Google News Scraper for broader social and news listening.

FAQ

Can I scrape a specific subreddit? Yes. Prefix the name with r/ (e.g., r/python). Use sort to control ordering.

How do I get top comments? Set includeComments: true. The actor will fetch top-level comments per post and attach them in topComments.

How recent are "hot" results? Hot results reflect Reddit's own ordering at run time — typically posts from the last 24-48 hours, weighted by engagement.

Does it work with NSFW subreddits? Yes, public NSFW subreddits are accessible. Each post carries an isNSFW flag.

Last verified: 2026-04

More scrapers at thirdwatch.dev.