Reddit API
Subreddit listings, subreddit metadata, user post history, and comment threads as JSON. One API key, no OAuth setup.
curl --request GET \
--url 'https://api.serply.io/v1/reddit/subreddit/python?limit=10&sort=hot' \
--header 'X-Api-Key: YOUR_API_KEY'{
"kind": "Listing",
"data": {
"after": "t3_1vpk70t",
"children": [
{
"kind": "t3",
"data": {
"title": "Showcase Thread",
"subreddit_name_prefixed": "r/Python",
"selftext": "Post all of your code/projects/showcases here...",
"score": 42,
"num_comments": 118
}
}
]
}
}Read Any Subreddit
Pass a subreddit name without the r/ prefix and get its post listing back. Sort by hot, new, or top, pair a top sort with a time window from an hour to all time, and take between 1 and 100 posts per request. The companion about endpoint returns metadata about the subreddit itself.
Users and Comment Threads
Pull a user's post history by username, or fetch a post's full comment tree by the same post ID that appears in its URL. A thread arrives in one request rather than one per level: the comments response carries two listings, the post first and then its comment tree, under a small envelope holding a cached flag alongside the data.
Reddit's Own JSON, Untouched
The response passes through as Reddit returns it: a kind tag and a data object holding an after cursor and a children array, each child carrying its own kind and data. Code that already reads Reddit listings needs no translation layer, and nothing breaks the day you decide to read a field this page never mentioned.
No OAuth, No App Registration
No Reddit app to register, no OAuth dance, and no refresh tokens to keep alive in a cron job. Authenticate with the same X-Api-Key header as every other Serply endpoint and pay a flat prepaid credit per successful uncached request.
Frequently Asked Questions
What is the Reddit API from Serply?
It is a REST wrapper over Reddit's own JSON. Four endpoints cover the things people actually pull from Reddit: a subreddit's post listing, a subreddit's metadata, a user's post history, and a post's comment thread. You authenticate with the same X-Api-Key header as every other Serply endpoint and read back Reddit's own listing shape.
Which endpoints are available?
GET /v1/reddit/subreddit/{subreddit} returns a subreddit's post listing. GET /v1/reddit/subreddit/{subreddit}/about returns metadata about the subreddit itself. GET /v1/reddit/user/{username} returns a user's post history. GET /v1/reddit/comments/{id} returns a post and its comment tree.
What shape is the response?
Reddit's own listing shape, untouched: a kind tag and a data object holding an after cursor and a children array, where each child carries its own kind and data (t3 for a post, t1 for a comment). Anything that already knows how to read a Reddit listing needs no translation layer. The about endpoint returns a single object rather than a listing. The comments endpoint is the one exception to the passthrough: it returns an envelope of the form { cached, data }, where data holds two listings - the post first, then its comment tree.
How do I paginate through more than 100 posts?
The limit parameter accepts 1 to 100 and defaults to 25. For more than that, read data.after from the response and pass it back as the after parameter on the next request. When after comes back null, you are on the last page.
Can I sort by top posts this week or this month?
Yes. Pass sort with hot, new, or top, and pair a top-style sort with the t parameter to set the window: hour, day, week, month, year, or all. Listings default to hot, and comment threads default to confidence. The about endpoint takes no query parameters.
Do I need a Reddit account or OAuth credentials?
No. There is no Reddit app registration, no OAuth dance, and no refresh-token handling to maintain. One X-Api-Key header on a plain GET request is the whole integration.
What can I build with a Reddit API?
Brand and product monitoring, community sentiment tracking, dataset collection for model training and evaluation, and retrieval over live discussion for AI agents that need what people are saying right now rather than what a training cutoff remembers.
How much does the Reddit API cost?
New accounts include 2,500 free credits. After that you buy prepaid credits that never expire, and one credit is deducted per successful uncached request. Responses are cached for 10 minutes, and a cached response costs nothing.
Start Building with the Reddit API Today
Join thousands of developers using Serply to build monitoring tools, research pipelines, and AI agents grounded in live discussion.