Reddit API
The Reddit API gives you structured JSON access to subreddits, posts, comment threads, and user profiles across all of Reddit β by API key, with no Reddit account or OAuth. Reddit's 2023 access changes locked down the official API; these endpoints give you clean, ready-to-use data through every Anysite surface (REST, MCP, CLI).
What Is the Reddit API?
Reddit is the largest discussion platform on the web β tens of thousands of communities (subreddits) where people post, comment, and vote. The Anysite Reddit endpoints expose that graph as structured JSON: discover communities by keyword, pull a subreddit's posts by sort and time window, read full nested comment threads, and resolve any username to a karma breakdown and post history. No scraping, no OAuth dance, no Reddit app registration β just an API key.
All 11 Endpoints
Posts & Comments
| Endpoint | What It Returns |
|---|---|
POST /api/reddit/posts |
A single post by id or URL: title, body, score, author, and comment count. |
POST /api/reddit/posts/comments |
The full comment thread of a post, with nested replies. |
POST /api/reddit/subreddits/posts |
Posts from a subreddit with sort (hot, new, top, rising) and time_filter (hourβ¦all). |
Discovery & Community
| Endpoint | What It Returns |
|---|---|
POST /api/reddit/subreddits |
Subreddit metadata: subscribers, description, type, language, NSFW & quarantine flags. |
POST /api/reddit/subreddits/popular |
The most popular subreddits, ranked by subscriber volume. |
POST /api/reddit/search/subreddits |
Find communities by keyword. |
POST /api/reddit/search/posts |
Cross-subreddit keyword search across all of Reddit. |
User Enrichment
| Endpoint | What It Returns |
|---|---|
POST /api/reddit/user |
A full user profile: karma breakdown (link vs comment), account age, and mod status. |
POST /api/reddit/search/users |
Search users; returns link_karma, comment_karma, is_mod, and verification. |
POST /api/reddit/user/posts |
A user's post history across subreddits. |
POST /api/reddit/user/comments |
A user's comment history across subreddits. |
What Can You Build with the Reddit API?
Community & Audience Research
Search subreddits by keyword and pull subscriber counts and metadata to map exactly where your audience already gathers.
Post & Trend Intelligence
Track hot and top posts across subreddits, then read the full comment threads to surface sentiment and emerging topics in real time.
Creator & Influencer Mapping
Resolve usernames to karma breakdown, account age, and mod status. The link-vs-comment karma ratio signals creators vs responders; is_mod flags community authority.
Brand & Product Monitoring
Run cross-subreddit search for brand or product mentions, then drill into the comment thread behind every hit.
Quick-Start Examples
Get a subreddit's hot posts:
curl -X POST https://anysite.io/api/reddit/subreddits/posts \
-H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" \
-d '{"subreddit": "programming", "sort": "hot", "time_filter": "day"}'
Search across Reddit for a keyword:
curl -X POST https://anysite.io/api/reddit/search/posts \
-H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" \
-d '{"query": "data pipeline"}'
Resolve a username to a full profile:
curl -X POST https://anysite.io/api/reddit/user \
-H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" \
-d '{"username": "spez"}'
Plans
Every endpoint is included in all Anysite plans β there's no per-endpoint pricing to track. Use MCP Unlimited for flat-rate access through your AI tools, or a credit plan for REST & CLI at scale.
Frequently Asked Questions
-
Do I need a Reddit account or OAuth?No. Every endpoint authenticates with your Anysite API key. There is no Reddit app to register, no OAuth flow, and no per-user token β you call the endpoint and get structured JSON back.
-
How do I sort and filter a subreddit's posts?The
/api/reddit/subreddits/postsendpoint takes asortof hot, new, top, or rising and atime_filterof hour, day, week, month, year, or all. (There is nocontroversialsort value.) -
Can I read full comment threads?Yes.
/api/reddit/posts/commentsreturns the full comment thread for a post, including nested replies, in structured form β no recursive id-by-id fetching. -
What user signals are available?
/api/reddit/userreturns a karma breakdown (link vs comment), account age, and mod status. The link-vs-comment karma ratio is a useful creator-vs-responder signal, and is_mod indicates community authority.
Start Building with Reddit Data
Subreddits, posts, comment threads, and user profiles β structured JSON by API key. Sign up for a free Anysite account and start querying Reddit in minutes.
Get Started Free Read the Docs