Health Pricing About ← Back
R

Reddit API

by Reddit Free tier

Reddit's API provides access to the front page of the internet: browse any subreddit, read posts and nested comment threads, search all of Reddit, submit posts and comments, upvote/downvote, access user profiles, and manage subreddit moderation queues.

subredditspostscommentssearchmoderation

Quick Reference

Base URL https://oauth.reddit.com Auth type OAuth 2.0 Auth header Authorization: Bearer token_here Rate limit 100 requests/min (free) Pricing Free tier available Free quota Free for most developer use cases Documentation https://www.reddit.com/dev/api Endpoint status Live — HTTP 200 — endpoint is accessible1.10s (checked Mar 29, 2026) Builder score B 76% builder-friendly
Pricing
90
Latency
60
Depth
78

Authentication

Use OAuth 2.0. For read-only access use app-only credentials; for user actions use authorization code flow.

Authorization: Bearer token_here

Pricing

Model freemium Starting price Free tier available Free quota Free for most developer use cases
PlanPrice/moIncluded
Free Free 100 req/min OAuth, 10 req/min basic
Data API $0 Paid agreement for large-scale commercial use

Developer API is free for most use cases. Data API for large-scale commercial use requires a paid agreement with Reddit. Standard: 100 req/min.

Key Endpoints

MethodPathDescription
GET /r/{subreddit}/hot Get hot posts in a subreddit
GET /r/{subreddit}/comments/{id} Get post with comments
GET /search Search posts across Reddit
POST /api/submit Submit a new post
POST /api/comment Submit a comment
GET /user/{username}/overview Get user's posts and comments

Sample Request

curl "https://oauth.reddit.com/r/programming/hot?limit=5" \
  -H "Authorization: Bearer $REDDIT_ACCESS_TOKEN" \
  -H "User-Agent: MyApp/1.0 by YourUsername"

Sample Response

{
  "kind": "Listing",
  "data": {
    "children": [{
      "kind": "t3",
      "data": {
        "title": "New study shows...",
        "subreddit": "programming",
        "score": 2847,
        "num_comments": 134,
        "url": "https://example.com/article"
      }
    }]
  }
}

Data sourced from API Map. Always verify pricing and rate limits against the official Reddit documentation.