Reddit Post API
Get any Reddit post by URL: title, body, score, comment count, flair, and media. $0.01 per call.
Look up a single Reddit post by its URL and get the full post object: title, author, subreddit, body text, score, upvote ratio, comment count, crosspost count, flair, NSFW and spoiler flags, stickied and locked state, thumbnail, images, and video URL.
Try it live
Fill in the fields and hit Run to see a real response.
{
"ok": true,
"data": {
"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": 21,
"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
Accepts www.reddit.com and old.reddit.com post URLs in the /r/<sub>/comments/<id>/ format.
score, upvote_ratio, num_comments, and num_crossposts as Reddit shows them.
selftext for text posts, plus url, domain, thumbnail, images, and video_url for link, image, and video posts.
Removed or missing posts return NOT_FOUND, and you are not charged.
Post lookups are cached for 30 minutes.
Use cases
Link Previews
Render rich previews when users paste a Reddit link.
Engagement Tracking
Track score and comment growth on posts you care about.
Content Archiving
Store a structured copy of a post for research or compliance.
Quick start
Copy this snippet and start making calls.
const res = await fetch('https://api.yepapi.com/v1/reddit/post', {
method: 'POST',
headers: {
'x-api-key': 'YOUR_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({
"url": "https://www.reddit.com/r/Python/comments/1xennpj/sunday_daily_thread_whats_everyone_working_on/"
}),
});
const data = await res.json();
console.log(data);The Reddit Post API for single-post lookups
The YepAPI Reddit Post API returns one Reddit post as structured data. Send a post URL to /v1/reddit/post and get its title, author, subreddit, body, score, upvote ratio, comment count, flair, and media, at $0.01 per call.
Use it whenever you have a link and need the data behind it: previews, engagement tracking, archiving, or as the first step before reading the comments.
What does the Reddit Post API return?
A single Post object: id, name, title, author, subreddit, permalink, url, domain, selftext, score, upvote_ratio, num_comments, num_crossposts, created_utc, created_at, flair, is_self, is_video, over_18, spoiler, stickied, locked, thumbnail, images, and video_url. It is the same shape every Reddit feed endpoint uses.
Build Reddit link previews and trackers
When a user pastes a Reddit link, call /v1/reddit/post and render the title, subreddit, score, and thumbnail. To track a post's performance, call it on a schedule and record score and num_comments over time. Then use the Reddit Comments API with the same URL to pull the discussion.
Reddit Post 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. Post lookups are cached for 30 minutes, and a removed post (404) costs nothing.
Accepted URLs
Pass a full post URL such as https://www.reddit.com/r/Python/comments/1xennpj/... Old Reddit URLs work too. Short redd.it links are rejected with a VALIDATION_ERROR, so expand them first.
Try the Reddit Post 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 Reddit Post API against live Reddit data before you spend anything. The same key unlocks comments, subreddit, and user endpoints.
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
Look up a single Reddit post by its URL and get the full post object: title, author, subreddit, body text, score, upvote ratio, comment count, crosspost count, flair, NSFW and spoiler flags, stickied and locked state, thumbnail, images, and video URL.
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/post. 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
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.
Reddit User API
$0.01Get any Reddit user's profile: karma breakdown, account age, avatar, and status flags. $0.01 per call.
Reddit User Posts API
$0.01Get every post a Reddit user has submitted, sorted by new, hot, or top. $0.01 per call.
Reddit User Comments API
$0.01Get a Reddit user's comment history with the post each comment replied to. $0.01 per call.
Reddit Popular Posts API
$0.01Get Reddit's r/popular feed by hot, new, top, or rising, optionally for one country. $0.01 per call.
Popular Subreddits API
$0.01List Reddit's most popular or newest subreddits with subscriber counts. $0.01 per call.