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).

11 endpoints  Β·  subreddits Β· posts Β· comments Β· users  Β·  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

EndpointWhat 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

EndpointWhat 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

EndpointWhat 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:

Shell
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:

Shell
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:

Shell
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/posts endpoint takes a sort of hot, new, top, or rising and a time_filter of hour, day, week, month, year, or all. (There is no controversial sort value.)
  • Can I read full comment threads?
    Yes. /api/reddit/posts/comments returns 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/user returns 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