Discover discussions
Search public RSS feeds by keyword, subreddit, ranking, and time window.
REDDIT API
Turn public conversations
into usable data.
Find the discussions that matter. Retrieve public Reddit posts and nested comments for research, discovery, and the tools you’re building.
Live private service · intermittent proxy failures
WHAT’S ON THE MAP
The data you need.
The details that matter.
Follow the conversation
Retrieve public posts with nested comments and reply relationships.
Understand coverage
Get explicit partial results when comments are capped or remain unloaded.
YOUR FIRST REQUEST
Get to the
good data.
Start with a local worker and a service key. The examples use the current Reddit contract.
POST
/v1/searchSearch discussions
RSS keyword discovery with optional subreddit, ranking, time-window, and result bounds. Unknown scores and metrics remain null.
Request and response fieldsPOST
/v1/threadsRetrieve threads
Retrieve posts and nested comments from canonical HTTPS www.reddit.com post permalinks. Reaching a cap or leaving unloaded comments returns partial.
Request and response fieldsGET
/v1/reddit/subreddit/detailsSubreddit details
Read community metadata, rendered rules, images, dates and weekly metrics. A matching community search header can fill a missing subscriber count; unavailable required metadata stays null with explicit partial coverage.
Request and response fieldsGET
/v1/reddit/subredditSubreddit posts
Read one rendered page of up to 50 public posts with sort, timeframe, signed after continuation and optional trimmed records.
Request and response fieldsGET
/v1/reddit/subreddit/searchSubreddit search
Read public post, comment and media search sections. One signed cursor tracks each section independently and skips exhausted sections. A section failure retains usable results with explicit partial coverage. Ranking and page sizes can differ from the competitor.
Request and response fieldsGET
/v1/reddit/postPost details
Read one post and omit comments from the response. Canonical Reddit URLs and bounded same-origin mobile share-link redirects are supported.
Request and response fieldsGET
/v1/reddit/post/commentsPost comments (GET)
Read a post and up to 100 comments with nested replies (depth 8). Truncation is explicit. Pass the returned signed continuation unchanged with the same post URL to retrieve native comment fragments or visible focused replies. Source POST controls retain their hidden form cursor; hidden fallback links are excluded.
Request and response fieldsPOST
/v1/reddit/post/commentsPost comments (POST)
The same comments operation accepts JSON when a continuation is too large for a URL. Body limit 64 KiB; cursor limit 50,000 characters. Query/body mixing and cursor batching are rejected.
Request and response fieldsGET
/v1/reddit/post/transcriptPost transcript
Read published WebVTT captions by post/share or direct v.redd.it video URL. Preserve raw_vtt and parse rolling captions into plain text. A source without published captions returns transcriptNotAvailable; challenges and failed retrieval remain failures.
Request and response fieldsGET
/v1/reddit/searchGlobal search
Search public posts or comments with signed after continuation. Comment search supports relevance/new/top and no timeframe. Unknown card fields, including post bodies and comment parent identities, remain null.
Request and response fieldsQUICKSTART / LOCAL EXAMPLES
# Local worker · use your own service key
export BASE_URL="http://localhost:3006"
curl "$BASE_URL/v1/search" \
-H "x-reddit-retrieval-secret: $REDDIT_RETRIEVAL_SERVICE_SECRET" \
-H 'Content-Type: application/json' \
--data '{"query":"meal planning","subreddits":["MealPrepSunday"],"sort":"relevance","timeWindow":"month","maxPosts":10}'const baseUrl = "http://localhost:3006";
const url = new URL('/v1/search', baseUrl);
const response = await fetch(url, {
method: 'POST',
headers: {
'x-reddit-retrieval-secret': process.env.REDDIT_RETRIEVAL_SERVICE_SECRET,
'Content-Type': 'application/json'
},
body: JSON.stringify({
"query": "meal planning",
"subreddits": [
"MealPrepSunday"
],
"sort": "relevance",
"timeWindow": "month",
"maxPosts": 10
})
});
const data = await response.json();
console.log(data);POST
/v1/searchJSON responseExamples target local workers. Use the origin and credentials supplied for your service.
TAKE IT SOMEWHERE USEFUL
Made for what
you’re making.
Research your market
Find the language, questions, and recurring problems in public communities.
Build discovery tools
Surface relevant threads in research dashboards and internal workflows.
Analyze conversations
Send retrieved posts and comments to your own classification or analysis pipeline.
What can I retrieve?
Public RSS search results, canonical Reddit posts, and bounded nested comments. Search supports up to 50 posts; thread retrieval supports up to 10 permalinks and 100 comments per thread.
Is every comment included?
No. Comment and depth limits apply. Unloaded comments or reached limits produce an explicit partial result, so your application can decide how to use the data.
How do I connect?
Reddit currently runs as a private service. Use the service origin and x-reddit-retrieval-secret supplied by your operator. The reference includes local development examples.
Is this an official Reddit API?
No. ScrapeAtlas is independent and is not affiliated with Reddit. This endpoint retrieves supported publicly available data.