Search Reddit for posts matching keywords, scoped to specific subreddits or sitewide, with comments — no API key, no login, no browser required. Reddit's per-IP reputation varies; an occasional run may return partial results, and your own proxy gives the most consistent results.
One or more search terms. Each is searched separately (e.g. a brand, product, or topic).
Type:array
Default:
[
"XPENG G6"
]
Limit to these subreddits (optional)
subreddits
Optional
Subreddit names without 'r/'. Leave empty to search sitewide.
Type:array
Default:
[]
Direct post URLs (optional)
postUrls
Optional
Specific Reddit post URLs to fetch directly, bypassing search entirely.
Type:array
Default:
[]
Sort results by
sort
Optional
How Reddit should order matching posts before the actor collects them.
Type:string
Default:new
Options:
relevancenewtophotcomments
Time range
timeRange
Optional
Only return posts created within this time window.
Type:string
Default:year
Options:
hourdayweekmonthyearall
Max posts
maxPosts
Optional
Stop after collecting this many unique posts across all queries/subreddits combined.
Type:integer
Minimum:1
Maximum:2000
Default:50
Include comments
includeComments
Optional
Fetch each post's top comments in addition to the post itself.
Type:boolean
Default:false
Max comments per post
maxCommentsPerPost
Optional
Only used when 'Include comments' is on.
Type:integer
Minimum:1
Maximum:500
Default:20
Proxy configuration
proxyConfiguration
Optional
Leave this on. A proxy is now required for runs on the Apify platform: Reddit refuses Apify's shared platform egress IP outright, with a 403 on first contact before any challenge is issued, so a run with the proxy switched off fails every request (measured 2026-09-16 — the identical run through Apify Proxy finished 28/28 requests in the same minute). Switching it off is only useful when you run this actor locally from a clean IP. Left at the default below it goes out through Apify's RESIDENTIAL pool, which works. Reddit's modern search page (www.reddit.com/search/) answers well-reputed IPs with a lightweight, solvable challenge instead of a hard block — this actor solves it automatically, no browser needed. IP reputation is still mixed within any shared pool, including Apify's RESIDENTIAL group, so the actor retires a session and retries with a fresh IP whenever a request comes back blocked. For the most consistent results (especially at high volume), supply your own proxy (a paid mobile or premium residential provider works best) via 'Custom proxies' instead. See README.md for details.