# Reddit API

**Provider:** Reddit
**Category:** social
**Base URL:** `https://oauth.reddit.com`
**Auth:** oauth2 — `Authorization: Bearer token_here`
**Rate Limit:** 100 requests/min (free)
**Free Tier:** Yes — [object Object]
**Pricing:** Free tier available (freemium)
**Docs:** https://www.reddit.com/dev/api

## Description

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.

## Endpoints

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `https://oauth.reddit.com/r/{subreddit}/hot` | Get hot posts in a subreddit |
| GET | `https://oauth.reddit.com/r/{subreddit}/comments/{id}` | Get post with comments |
| GET | `https://oauth.reddit.com/search` | Search posts across Reddit |
| POST | `https://oauth.reddit.com/api/submit` | Submit a new post |
| POST | `https://oauth.reddit.com/api/comment` | Submit a comment |
| GET | `https://oauth.reddit.com/user/{username}/overview` | Get user's posts and comments |

## Authentication

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

```
Authorization: Bearer token_here
```

## Sample Request

```bash
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

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

## Pricing Details

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.

---

*Source: [API Map](https://apimap.dev/apis/reddit/) — CC BY 4.0*