# Reddit API

> Posts, comments, communities, people and what is trending.

Canonical page: https://okdata.online/apis/reddit/

11 endpoints, $0.002 to $0.004 per call. Region: Global. No Reddit login or cookies needed.

| Endpoint | ID | Returns | Price |
|---|---|---|---|
| [Reddit post search](https://okdata.online/apis/reddit/posts/search/) | `reddit.posts.search` | Post[] | $0.004 per call · about 25 posts per page |
| [Reddit post detail](https://okdata.online/apis/reddit/posts/get/) | `reddit.posts.get` | Post | $0.002 per call |
| [Reddit post comments](https://okdata.online/apis/reddit/posts/comments/list/) | `reddit.posts.comments.list` | Comment[] | $0.002 per call · about 10 comments per page |
| [Reddit Popular feed](https://okdata.online/apis/reddit/popular/posts/list/) | `reddit.popular.posts.list` | Post[] | $0.002 per call · about 10 posts per page |
| [Reddit community posts](https://okdata.online/apis/reddit/subreddits/posts/list/) | `reddit.subreddits.posts.list` | Post[] | $0.004 per call · about 25 posts per page |
| [Reddit community profile](https://okdata.online/apis/reddit/subreddits/get/) | `reddit.subreddits.get` | Account | $0.002 per call |
| [Reddit trending searches](https://okdata.online/apis/reddit/trends/list/) | `reddit.trends.list` | Trend[] | $0.002 per call · about 6 board entries per page |
| [Reddit user profile](https://okdata.online/apis/reddit/users/get/) | `reddit.users.get` | Account | $0.002 per call |
| [Reddit user posts](https://okdata.online/apis/reddit/users/posts/list/) | `reddit.users.posts.list` | Post[] | $0.002 per call · about 25 posts per page |
| [Reddit user active communities](https://okdata.online/apis/reddit/users/subreddits/list/) | `reddit.users.subreddits.list` | Account[] | $0.002 per call · about 30 accounts per page |
| [Reddit video transcript](https://okdata.online/apis/reddit/posts/transcript/get/) | `reddit.posts.transcript.get` | Transcript | $0.004 per call |

## Good for

- Word of mouth: `reddit.posts.search`, `reddit.posts.comments.list`
- Content research: `reddit.posts.search`, `reddit.posts.get`, `reddit.subreddits.posts.list`, `reddit.subreddits.get`, `reddit.posts.transcript.get`
- Competitor monitoring: `reddit.posts.get`, `reddit.subreddits.posts.list`, `reddit.subreddits.get`, `reddit.users.get`, `reddit.users.posts.list`
- Trend research: `reddit.popular.posts.list`, `reddit.trends.list`
- Creator discovery: `reddit.users.get`, `reddit.users.subreddits.list`
- Transcripts: `reddit.posts.transcript.get`

## At a glance

11 Reddit endpoints covering posts, popular, subreddits, hot lists and accounts, from $0.002 a call. No Reddit account or cookie needed, and a failed call costs nothing.

Categories: [Social media](https://okdata.online/categories/social/)

- **Endpoints**: 11 endpoints. In 5 groups, one response format.
- **Lowest price**: From $0.002. A call, paid from a prepaid balance.
- **Freshness**: Live. Boards are a shared snapshot up to 10 minutes old.
- **Failed calls**: $0. Errors and timeouts are never charged.

- [Start free](https://okdata.online/console/)
- Try one: [Reddit post search](https://okdata.online/apis/reddit/posts/search/)
- Reddit in Claude, Cursor and other agents: [Reddit MCP](https://okdata.online/mcp/reddit/)

## Endpoints by group

### Posts (4)

| Endpoint | Request | Returns | Price |
|---|---|---|---|
| [Post search](https://okdata.online/apis/reddit/posts/search/) | `GET /v1/reddit/posts/search` | Post[] | $0.004 per call |
| [Post detail](https://okdata.online/apis/reddit/posts/get/) | `GET /v1/reddit/posts/get` | Post | $0.002 per call |
| [Post comments](https://okdata.online/apis/reddit/posts/comments/list/) | `GET /v1/reddit/posts/comments/list` | Comment[] | $0.002 per call |
| [Video transcript](https://okdata.online/apis/reddit/posts/transcript/get/) | `GET /v1/reddit/posts/transcript/get` | Transcript | $0.004 per call |

### Popular (1)

| Endpoint | Request | Returns | Price |
|---|---|---|---|
| [Popular feed](https://okdata.online/apis/reddit/popular/posts/list/) | `GET /v1/reddit/popular/posts/list` | Post[] | $0.002 per call |

### Subreddits (2)

| Endpoint | Request | Returns | Price |
|---|---|---|---|
| [Community posts](https://okdata.online/apis/reddit/subreddits/posts/list/) | `GET /v1/reddit/subreddits/posts/list` | Post[] | $0.004 per call |
| [Community profile](https://okdata.online/apis/reddit/subreddits/get/) | `GET /v1/reddit/subreddits/get` | Account | $0.002 per call |

### Hot lists (1)

| Endpoint | Request | Returns | Price |
|---|---|---|---|
| [Trending searches](https://okdata.online/apis/reddit/trends/list/) | `GET /v1/reddit/trends/list` | Trend[] | $0.002 per call |

### Accounts (3)

| Endpoint | Request | Returns | Price |
|---|---|---|---|
| [User profile](https://okdata.online/apis/reddit/users/get/) | `GET /v1/reddit/users/get` | Account | $0.002 per call |
| [User posts](https://okdata.online/apis/reddit/users/posts/list/) | `GET /v1/reddit/users/posts/list` | Post[] | $0.002 per call |
| [User active communities](https://okdata.online/apis/reddit/users/subreddits/list/) | `GET /v1/reddit/users/subreddits/list` | Account[] | $0.002 per call |

- [Reddit API pricing](https://okdata.online/pricing/reddit/)
- [Reddit in your AI (MCP)](https://okdata.online/mcp/reddit/)
- [Live status](https://okdata.online/status/)

## What people do with Reddit data

- [Content research](https://okdata.online/solutions/content-research/): “What do the top posts on this topic have in common?” [Post search](https://okdata.online/apis/reddit/posts/search/) $0.004, [Post detail](https://okdata.online/apis/reddit/posts/get/) $0.002, [Community posts](https://okdata.online/apis/reddit/subreddits/posts/list/) $0.004
- [Competitor monitoring](https://okdata.online/solutions/competitor-monitoring/): “What did our competitors post this week, and what took off?” [Post detail](https://okdata.online/apis/reddit/posts/get/) $0.002, [Community posts](https://okdata.online/apis/reddit/subreddits/posts/list/) $0.004, [Community profile](https://okdata.online/apis/reddit/subreddits/get/) $0.002
- [Word of mouth](https://okdata.online/solutions/word-of-mouth/): “What do buyers complain about most?” [Post search](https://okdata.online/apis/reddit/posts/search/) $0.004, [Post comments](https://okdata.online/apis/reddit/posts/comments/list/) $0.002
- [Trend research](https://okdata.online/solutions/trend-research/): “What is trending today that we could ride?” [Popular feed](https://okdata.online/apis/reddit/popular/posts/list/) $0.002, [Trending searches](https://okdata.online/apis/reddit/trends/list/) $0.002
- [Creator discovery](https://okdata.online/solutions/creator-discovery/): “Who are the mid-size creators in camping gear?” [User profile](https://okdata.online/apis/reddit/users/get/) $0.002, [User active communities](https://okdata.online/apis/reddit/users/subreddits/list/) $0.002
- [Transcripts](https://okdata.online/solutions/transcripts/): “Which products did this channel recommend?” [Video transcript](https://okdata.online/apis/reddit/posts/transcript/get/) $0.004

## Start in three steps

1. Get a key: [open the console](https://okdata.online/console/). A new key comes with $0.10 to try, no card.
2. Connect your AI with this sentence (swap in your key), or call the API yourself:

   > Set up okdata for me by following https://okdata.online/agents.md. Here is my okdata API key: okd_…. Keep it safe and use it for all okdata calls.

3. Make the first call (Reddit post search). Items arrive in data.items, the next page in page.next_cursor, the charge in meta.billing.amount.

```bash
curl -G "https://api.okdata.online/v1/reddit/posts/search" \
  -H "Authorization: Bearer $OKDATA_API_KEY" \
  --data-urlencode 'query=saturn rings'
```

## Questions about the Reddit API

### What does the Reddit API cost?

Each of the 11 endpoints has its own price, from $0.002 to $0.004 a call; the cheapest is Reddit Popular feed at $0.002. You pay per call from a prepaid balance, with no subscription, and a failed call is not charged.

### Do I need a Reddit account or cookie?

No. You call https://api.okdata.online with one okdata key and get public Reddit data back; no Reddit account, cookie or QR login is involved.

### How fresh is the data?

Most endpoints read Reddit at the moment you call. Hot lists come from a shared snapshot that is at most 10 minutes old.

### Can my AI agent use the Reddit API?

Yes. Connect the MCP server at https://api.okdata.online/mcp: its find tool lists these 11 endpoints with their prices, and its call tool runs them on your key.

### Can I try it for free?

New accounts get $0.10 of trial credit with no card: enough for 50 calls to Reddit Popular feed.

## More about Reddit

- [How to search Reddit posts by keyword and collect their comments](https://okdata.online/guides/reddit-search-posts-and-comments/)
- [Comments API](https://okdata.online/roles/posts-comments-list/)
- [Trending topics API](https://okdata.online/roles/trends-list/)
- [Profile API](https://okdata.online/roles/accounts-get/)
- [Account posts API](https://okdata.online/roles/accounts-posts-list/)
- [Post detail API](https://okdata.online/roles/posts-get/)
- [Post search API](https://okdata.online/roles/posts-search/)
- [Trending posts API](https://okdata.online/roles/posts-trending/)
- [Community posts API](https://okdata.online/roles/communities-posts-list/)
- [Transcript API](https://okdata.online/roles/transcripts-get/)
- [Reddit trending searches: today’s list](https://okdata.online/tools/hot-search/reddit/)

## Other platforms

[Douyin API](https://okdata.online/apis/douyin/) · [Xiaohongshu (RedNote) API](https://okdata.online/apis/xiaohongshu/) · [WeChat Official Accounts API](https://okdata.online/apis/wechat_mp/) · [Bilibili API](https://okdata.online/apis/bilibili/) · [Weibo API](https://okdata.online/apis/weibo/) · [TikTok API](https://okdata.online/apis/tiktok/) · [X (Twitter) API](https://okdata.online/apis/x/) · [YouTube API](https://okdata.online/apis/youtube/) · [Meta Ad Library API](https://okdata.online/apis/meta/) · [Google Ads Transparency API](https://okdata.online/apis/google/) · [Instagram API](https://okdata.online/apis/instagram/) · [Kuaishou API](https://okdata.online/apis/kuaishou/) · [Zhihu API](https://okdata.online/apis/zhihu/) · [WeChat Channels API](https://okdata.online/apis/wechat_channels/) · [WeChat Search API](https://okdata.online/apis/wechat/) · [Telegram API](https://okdata.online/apis/telegram/)