Skip to main content
Reddit endpoints live under /v1/reddit/*. See the API Reference for the full endpoint list. Credit rates are in Credits.

​
Pagination

Search, listings, trending, duplicates, and user activity endpoints use an opaque nextCursor. Pass it back unchanged on the next request. Internal page size is capped (~25 default, ~100 max). Search results are capped at roughly 250 items per query; listings at roughly 1000.

​
NSFW content

NSFW posts are included by default on all content listings and watches. Pass include_nsfw=false to opt out. The isNsfw field is always present on post objects. When creating a watch, omit include_nsfw or set it to true to include NSFW matches. Set include_nsfw: false to filter them out.

​
Search operators

Post search (GET /v1/reddit/search/posts) supports Reddit-style query syntax in the q parameter — for example title:keyword, author:username, flair:text, self:yes, url:domain.com. Scope to a subreddit with the subreddit query param. Subreddit and user search return lean hit objects; full profiles are on the about routes (/subreddits/:name, /users/:username). Popular and new subreddit listings (/subreddits/popular, /subreddits/new) also return lean hits.

​
Domain posts

GET /v1/reddit/domains/:domain/posts lists posts linking to a domain. The domain param accepts bare hostnames or URLs (protocol is stripped). Default sort is new; optional sort and t match subreddit listings.

​
Wiki

Page content (GET /v1/reddit/subreddits/:name/wiki/:page) returns markdown and HTML plus revision metadata.

​
User extras

GET /v1/reddit/users/:username/moderated lists moderated subreddits. GET /v1/reddit/users/:username/trophies returns trophy awards.

​
Post detail vs comments

GET /v1/reddit/posts/:id returns the post only. The comment tree is on GET /v1/reddit/posts/:id/comments. Comment responses are nested (replies[]). Use sort (confidence, top, new, controversial, old, qa, live), depth (0–10), and cursor to paginate through morechildren batches. Billing is variable — see Credits. Each response includes meta.credits_used.

​
Soft 404 (definitive, still billed)

Credits are charged for these definitive 404s on the relevant endpoint.

​
Post ids

:id accepts bare base36 ids or fullnames (t3_…). Responses always normalize to bare id plus fullname.

​
Watches

Reddit watches poll post search or subreddit listings and deliver post.created webhooks with the full enriched post shape. See Watches and Webhooks.