Reddit Content Aggregation API
Pull top posts from any subreddit on a recurring schedule to power newsletters, content curation tools, or trend-spotting dashboards — a common use case distinct from brand monitoring, since it's about surfacing the best content rather than tracking specific mentions.
How the Reddit Content Aggregation API Workflow Works
Use Reddit's /top, /hot, or /new .json endpoints for any subreddit to pull a ranked list of posts on your chosen cadence — daily for a newsletter digest, hourly for a live trend dashboard. Each post includes score, comment count, and (for link posts) the external URL, which is enough to build a 'best of' curation without needing to render Reddit's UI at all. For multi-subreddit aggregation (e.g. a newsletter covering several tech communities), fan out one request per subreddit and merge results by score before selecting your top N.
Recommended Tier & Cost
Listing endpoints (.json appended to /top, /hot, /new) return structured data directly without rendering and at lower request volume than full social-listening jobs, so they typically resolve at Tier 1.
Sample Output
{
"subreddit": "r/technology",
"listing": "top",
"time_window": "day",
"posts": [
{
"post_id": "1a2b3c4",
"title": "New open-source tool simplifies X",
"score": 4821,
"num_comments": 312,
"external_url": "https://example.com/article",
"created_utc": "2026-07-10T06:00:00Z"
}
]
}Need an API key? — no credit card required.
Responsible Use
AlterLab is designed for extracting publicly available data. Always review the terms of service for Reddit, respect robots.txt directives, and ensure your use case complies with applicable laws in your jurisdiction. Do not use this service to access non-public, authenticated, or personally identifiable data without appropriate authorization.
Quick Start
# Always verify Reddit's robots.txt and terms of service before extracting data.
curl -X POST https://alterlab.io/api/v1/scrape \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://www.reddit.com/r/webdev/top/.json",
"advanced": { "render_js": false }
}'Frequently Asked Questions
Can I aggregate posts from multiple subreddits into one feed?
Yes — request each subreddit's listing endpoint separately and merge the results in your own pipeline, ranking by score or recency across the combined set.
How often can I refresh a content aggregation feed?
As often as your product needs — hourly refreshes are common for live trend dashboards, while daily or weekly is typical for a newsletter digest.
Does this include the linked external article content?
The listing response includes the external_url for link posts, but not the linked page's content itself — scrape that URL separately if you need the full article text.
Related Guides
Developer Scraping Resources
How to Scrape Reddit Data: Complete Guide
Step-by-step tutorial with Python and Node.js code examples, structured extraction, and cost breakdown for Reddit scraping.
How to Handle Bot Protection Challenges
All 6 detection layers explained: TLS fingerprinting, JS challenges, Turnstile, and more.
JavaScript Rendering API
Full browser rendering for SPAs, React, and dynamic content.
Python Web Scraping API
pip install alterlab — async-ready Python SDK with 5,000 free scrapes.
Pricing
From $0.0002/request. No subscriptions. Balance never expires.
Your first scrape.
Sixty seconds.
$1 free credit — up to 5,000 scrapes. No credit card.
Just a POST request.
No credit card required · $1 free credit, up to 5,000 scrapes · Balance never expires