Subreddit monitors
Reddit Monitor API
Follow one subreddit for new and updated public posts—checks, events, and observed posts over JSON. Built for automation, not brand-listening SaaS.
Monitor lifecycle
Create a subreddit monitor, run checks, then read events and collected posts.
Create monitor
Point a monitor at one public subreddit (sort and interval per docs).
Check / events
Trigger checks and inspect event history for new or updated posts.
Observed posts
List posts the monitor has recorded for your automation.
List / get free meters
Documented list/get routes use free meters when billing is active; checks and post records bill per Pricing.
Not keyword alerts
Monitors follow one subreddit—not global brand mentions.
Not full history
Monitors are forward-looking collection helpers, not archives.
How monitors work
- Create a monitor for one subreddit via POST /v1/reddit/monitors.
- Run checks on your schedule; inspect events and posts.
- Use list/get routes for status; confirm check and post-record meters on Pricing.
$ curl -sS -X POST "$SPIDER_BASE_URL/v1/reddit/monitors" \
-H "Authorization: Bearer $SPIDER_API_KEY" \
-H "Content-Type: application/json" \
-d '{"subreddit":"datascience","sort":"new"}' Not a brand-mention product
If you need keyword listening or a brand inbox across Reddit, expectations will not match. This API tracks new/updated posts inside one subreddit you choose.
Is this the right fit?
Choose this path for managed public Reddit JSON. Do not expect:
- Full historical Reddit archive or deleted-content recovery
- Keyword or brand-mention monitoring inbox
- Private, quarantined, or logged-in-only content
- Official Reddit API approval bypass or write/mod OAuth replacement
- Hard-coded credit unit prices on this page—see Pricing for meters
- Cross-subreddit brand mention or listening inbox
Credits & billing
Public reads and successful deliveries use Plan Credits. Exact meters and rates follow Pricing; failed requests on our side are not charged when billing is active. Confirm live meters in Pricing and the Reddit API docs before publishing numbers.
Frequently asked questions
Start with the Reddit Monitor API
Create a subreddit monitor from the console after reviewing the docs.