Subreddit Posts API
Pull hot, new, top, or controversial posts from any subreddit as JSON. A subreddit scraper at $0.01 per call.
Get the post feed of any public subreddit sorted by hot, new, top, or controversial, with a time range for top and controversial. Each post includes title, author, score, upvote ratio, comment count, body text, flair, images, and video URL, with cursor pagination to walk the whole feed.
Try it live
Fill in the fields and hit Run to see a real response.
{
"ok": true,
"data": {
"cursor": "t3_1xe1zp2",
"posts": [
{
"author": "AutoModerator",
"created_at": "2026-10-25T00:00:09+00:00",
"created_utc": 1792886409,
"domain": "self.Python",
"flair": ":pythonLogo: Daily Thread",
"id": "1xennpj",
"images": [],
"is_self": true,
"is_video": false,
"locked": false,
"name": "t3_1xennpj",
"num_comments": 35,
"num_crossposts": 0,
"over_18": false,
"permalink": "https://www.reddit.com/r/Python/comments/1xennpj/sunday_daily_thread_whats_everyone_working_on/",
"score": 22,
"selftext": "# Weekly Thread: What's Everyone Working On This Week? 🛠️\n\nHello r/Python! It's time to share what you've been working on! Whether it's a work-in-progress, a completed masterpiece, or just a rough ide…",
"spoiler": false,
"stickied": true,
"subreddit": "Python",
"thumbnail": null,
"title": "Sunday Daily Thread: What's everyone working on this week?",
"upvote_ratio": 0.94,
"url": "https://www.reddit.com/r/Python/comments/1xennpj/sunday_daily_thread_whats_everyone_working_on/",
"video_url": null
}
]
}
}Features
Pick the same sort tabs Reddit shows on a subreddit. Top and controversial accept a time range from the past hour to all time.
Every post includes id, title, author, permalink, url, domain, selftext, score, upvote_ratio, num_comments, num_crossposts, created_at, flair, stickied, locked, images, and video_url.
Pass the returned cursor back to page through a subreddit's feed, newest or highest-voted first.
Accepts python, r/python, or a full subreddit URL.
Feeds are cached for 15 minutes and request pacing is handled server-side.
Use cases
Content Monitoring
Watch a subreddit's new posts for mentions, questions, or leads.
Trend Research
Pull the top posts of the week or month to see what a community cares about.
Datasets
Collect a subreddit's post history for analysis or model training.
Quick start
Copy this snippet and start making calls.
const res = await fetch('https://api.yepapi.com/v1/reddit/subreddit-posts', {
method: 'POST',
headers: {
'x-api-key': 'YOUR_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({
"subreddit": "python",
"sort": "hot"
}),
});
const data = await res.json();
console.log(data);The Subreddit Posts API: a subreddit scraper that returns JSON
The YepAPI Subreddit Posts API returns the post feed of any public subreddit. Send a subreddit and a sort to /v1/reddit/subreddit-posts and get back posts with title, author, score, upvote ratio, comment count, body text, flair, and media, plus a cursor for the next page. Each call costs $0.01.
It replaces a home-made subreddit scraper: no HTML parsing, no proxy rotation, no OAuth app, and the same output shape every time.
What is a subreddit scraper?
A subreddit scraper collects the posts from a Reddit community so you can analyze or store them. Scraping the pages yourself means fighting layout changes and blocks. The Subreddit Posts API gives you the same feed as clean JSON: one POST request per page, with the same sort tabs Reddit shows (hot, new, top, controversial) and a cursor to keep going.
Build a subreddit monitor
Poll /v1/reddit/subreddit-posts with sort=new every 15 minutes, keep the ids you have already seen, and push new posts to Slack, a CRM, or an AI classifier. For trend reports, call it with sort=top and time=week to get the most upvoted posts of the week. Then open any post with the Reddit Comments API.
Subreddit Posts API pricing: $0.01 per call
Every call costs a flat $0.01 and failed calls are free. There is no monthly minimum, no seat fee, and no Reddit app to register: you only need a YepAPI key. A page of posts is one call, so walking 10 pages of a feed costs $0.10. Feeds are cached for 15 minutes.
Sorts and time ranges
sort=hot (default) mirrors the subreddit front page, sort=new is best for monitoring, and sort=top or sort=controversial accept time=hour, day, week, month, year, or all. The subreddit field takes python, r/python, or a full URL.
Try the Subreddit Posts API free
Sign up and get $5 in free credit with no card required. That is 500 calls at $0.01 each to test the Subreddit Posts API against live Reddit data before you spend anything. The same key covers subreddit info, rules, comments, and the rest of the Reddit API.
Start making API calls in 30 seconds
$5 free credit on signup. No credit card required. Pay per call.
What developers say
“Switched from SerpAPI and cut our SERP costs by 80%. Same data quality, way simpler billing.”
“One API key for AI models, SERP data, and web scraping. Saved us from managing 4 separate providers.”
“The $5 free credit let us prototype our entire rank tracking feature before committing. No other API does that.”
Frequently asked questions
Get the post feed of any public subreddit sorted by hot, new, top, or controversial, with a time range for top and controversial. Each post includes title, author, score, upvote ratio, comment count, body text, flair, images, and video URL, with cursor pagination to walk the whole feed.
Each API call costs $0.01. No monthly minimums or subscriptions — you only pay for what you use.
Sign up for a free API key, then send a POST request to /v1/reddit/subreddit-posts. Check the code example above for a ready-to-use snippet in JavaScript, cURL, or Python.
YepAPI bundles SEO, AI, and web scraping APIs under one key with no monthly minimums. You get lower per-call pricing, a unified dashboard, and one billing account instead of managing multiple providers.
Ready to integrate?
Get your API key and start making calls in 30 seconds. $5 free credit on signup — no credit card required.
More Reddit API endpoints
Subreddit Comments API
$0.01Stream the latest comments posted anywhere in a subreddit, with post context. $0.01 per call.
Subreddit Rules API
$0.01Get a subreddit's posting rules with descriptions and removal reasons. $0.01 per call.
Similar Subreddits API
$0.01Find subreddits related to any community, with subscriber counts and descriptions. $0.01 per call.
Subreddit API
$0.01Get any subreddit's subscribers, description, sidebar, settings, and branding as JSON. $0.01 per call.
Reddit Post API
$0.01Get any Reddit post by URL: title, body, score, comment count, flair, and media. $0.01 per call.
Reddit Comments API
$0.01Get the full comment tree of any Reddit post with nested replies. A Reddit comment scraper at $0.01 per call.