Reddit API reference
Public Reddit search, subreddit feeds, comments, and transcripts over REST — one API key, no Reddit OAuth.
Social Fetch's Reddit tag is seven GET /v1/reddit/... routes. Pass a subreddit name, post URL, or search query and get { data, meta } with data.lookupStatus, meta.requestId, and meta.creditsCharged. Authenticate with x-api-key only — no Reddit developer app, no OAuth.
These pages are generated from the public OpenAPI spec. Product overview, examples, and credit notes also live on the Reddit platform hub. Listening workflow: Reddit research recipe. Keys and official vs public-data access: How to get a Reddit API key.
Credits
Every Reddit route is 1 credit per completed lookup. Paginated search, feed, and comment calls bill each page. An empty completed search still bills; lookup_failed and 503 do not. Trust meta.creditsCharged.
Search and subreddits
Site-wide search
`GET /v1/reddit/search` — keyword posts across public Reddit.
Subreddit metadata
`GET /v1/reddit/subreddits` — community card by name or URL.
Subreddit feed
`GET /v1/reddit/subreddits/{subreddit}/posts` — ranked posts, cursor-paged.
Search inside a subreddit
`GET /v1/reddit/subreddits/search` — query one community.
Posts
Post
`GET /v1/reddit/posts` — title, text, metrics, and flags for a post URL.
Post comments
`GET /v1/reddit/posts/comments` — comment tree for a post URL.
Post transcript
`GET /v1/reddit/posts/transcript` — spoken text when Reddit exposes captions.
Related
- Reddit platform hub — coverage, FAQs, and credit notes
- Reddit API pricing — official vs public-data cost
- How to get a Reddit API key
- API reference — all platforms