Reddit subreddit posts API
List public posts from a known subreddit — title, text, author, scores, flags — with cursor pagination in the shared Social Fetch envelope.
GET /v1/reddit/subreddits/{subreddit}/posts1 credit per successful request.
About this endpoint
Brand monitors and research agents often start with a community they already know: r/SaaS, r/personalfinance, a niche product sub. They need that feed as structured rows, not a brittle scrape of old.reddit or a half-finished OAuth client.
`GET /v1/reddit/subreddits/{subreddit}/posts` takes the subreddit name in the path (r/ prefix and subreddit URLs are accepted) and returns a page of public posts. Optional `sort` (`best`, `hot`, `new`, `top`, `rising`) and `timeframe` (`day` through `all`) shape the feed; keep the same sort and timeframe when you paginate. Branch on `data.lookupStatus` before you write rows. On `found`, read `data.posts` and `data.page`. When `data.page.hasMore` is true, pass `data.page.nextCursor` as `cursor` on the next call. Bill from `meta.creditsCharged`.
This route is the feed for one community. Site-wide keyword search is `GET /v1/reddit/search`. Search inside a subreddit is `GET /v1/reddit/subreddits/search`. Subreddit metadata alone is `GET /v1/reddit/subreddits/{subreddit}`. All of them share one Social Fetch API key.
Reddit subreddit posts API FAQ
How do I list posts from a Reddit subreddit via API?
Call GET /v1/reddit/subreddits/{subreddit}/posts with x-api-key and the community name in the path. Optionally add sort, timeframe, and cursor. Read data.lookupStatus, then data.posts and data.page. Full parameters and examples are in the API docs.
What does each subreddit post include?
Each item can include id, fullId, subreddit, title, text, author (username and id when available), url, permalinkUrl, publishedAt, metrics (score, upvotes, upvoteRatio, commentCount, crosspostCount, subredditSubscribers), and flags (isVideo, isPinned, isLocked, isSpoiler, isOver18, isOriginalContent).
How much does the Reddit subreddit posts endpoint cost?
Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged — that field is the billing source of truth. Each paginated page is a separate billed request.
How does pagination work on subreddit posts?
When data.page.hasMore is true, pass data.page.nextCursor as the cursor query param on the next request. Keep the same sort and timeframe across pages. The cursor is opaque — do not invent or parse it.
Can I sort a subreddit feed by hot, new, or top?
Yes. sort accepts best, hot, new, top, or rising. timeframe accepts all, day, week, month, or year and applies with time-based sort orders. Pass both as query params on the first request and keep them stable while paging.
Subreddit posts vs Reddit search vs subreddit search?
Use this route when you already know the community and want its feed. Use GET /v1/reddit/search for site-wide post keyword search. Use GET /v1/reddit/subreddits/search to search within a community or find communities. They are separate operations on the Reddit hub.
What if the subreddit does not exist?
Branch on data.lookupStatus. Unknown communities resolve as not_found. A found lookup may still return an empty posts array. Keep meta.requestId if you need support on a failed list call.
Do I need Reddit OAuth to pull a subreddit feed?
No. You authenticate to Social Fetch with an API key. The route reads public subreddit feeds; it does not act on behalf of a logged-in Reddit user or open private subreddits.