# Reddit data API for AI agents: from $0.002 per call ($2 per 1,000), no subscription

> Whizbrew's Reddit data API costs from $0.002 per call ($2 per 1,000 calls); a typical call is $0.002 ($2 per 1,000). Only a call that returns data is charged: an empty or failed call is free. There is no subscription and no monthly fee. A new account starts with $2 of free credit, with no card.

It reads Reddit posts, comments, subreddits, users and search: 12 tools, live at the moment of the call, over one API key or one MCP server (`https://whizbrew.com/mcp`). It is an API, not a scraper you run: no proxies, no browser and no scraping code on your side. The same key reaches 893 tools for other platforms ([all APIs](https://whizbrew.com/api), [all tools](https://whizbrew.com/tools?a=62756b0d1f91), [pricing](https://whizbrew.com/pricing?a=62756b0d1f91)).

## Pricing

| Tool | What it returns | Per call that returns data | Per 1,000 calls |
|---|---|---|---|
| `reddit.search` | Search Reddit threads inside one subreddit, or in up to 5 subreddits in one call (newest first across them). Pass "subreddit": search across all of Reddit is not available on every deployment, and a call without one is then refused as bad_input (reddit.subreddit_search finds subreddits by name). Slow: the archive it reads takes 5 to 20 seconds for one subreddit. | $0.002 | $2 |
| `reddit.posts` | Newest posts of a subreddit. Scores are a snapshot: scores_as_of says when they were captured. | $0.002 | $2 |
| `reddit.post` | One Reddit post by its link or id, with its full text. Scores are a snapshot: scores_as_of says when they were captured. | $0.002 | $2 |
| `reddit.comments` | Comments on a Reddit post in reading order, with depth and parent, up to 200 (a longer thread is cut there). Scores are a snapshot: scores_as_of says when they were captured. | $0.002 | $2 |
| `reddit.user_posts` | Newest posts of a Reddit user. Scores are a snapshot: scores_as_of says when they were captured. | $0.002 | $2 |
| `reddit.user_comments` | Newest comments of a Reddit user, with the post each is on. Scores are a snapshot: scores_as_of says when they were captured. | $0.002 | $2 |
| `reddit.subreddit` | Subreddit details: title, description, subscribers, totals. A stored copy: as_of says how old it is. | $0.002 | $2 |
| `reddit.user_subreddits` | The subreddits a Reddit user posts and comments in most. | $0.002 | $2 |
| `reddit.user` | A Reddit user's karma, post and comment counts and first and last activity. A stored copy: as_of says how old it is. | $0.002 | $2 |
| `reddit.subreddit_search` | Subreddits whose name starts with the given text, biggest first. Stored copies: as_of says how old each is. | $0.002 | $2 |
| `reddit.popular` | The posts on Reddit's popular page right now, in Reddit's order. No scores. Refreshed every ten minutes. | $0.002 | $2 |
| `reddit.top` | The top posts of a subreddit for a period, in Reddit's order. No scores. Refreshed every ten minutes. | $0.002 | $2 |

## Example calls

`reddit.search` ($0.002 per call): Search Reddit threads inside one subreddit, or in up to 5 subreddits in one call (newest first across them)

```
curl -s -X POST https://whizbrew.com/v1/call/reddit.search \
  -H "Authorization: Bearer $WHIZBREW_KEY" -H "content-type: application/json" \
  -d '{"limit":3,"query":"chicken","subreddit":"mealprep"}'
```

`reddit.posts` ($0.002 per call): Newest posts of a subreddit

```
curl -s -X POST https://whizbrew.com/v1/call/reddit.posts \
  -H "Authorization: Bearer $WHIZBREW_KEY" -H "content-type: application/json" \
  -d '{"limit":3,"subreddit":"rust"}'
```

`reddit.post` ($0.002 per call): One Reddit post by its link or id, with its full text

```
curl -s -X POST https://whizbrew.com/v1/call/reddit.post \
  -H "Authorization: Bearer $WHIZBREW_KEY" -H "content-type: application/json" \
  -d '{"url":"https://www.reddit.com/r/announcements/comments/t93ec3/this_subreddit_is_closed_for_new_posts_and/"}'
```

Over MCP the same call is `call_tool` with `{"tool": "<name>", "arguments": {…}}`. How often each tool works, measured from real calls: [https://whizbrew.com/status](https://whizbrew.com/status).

## Start

- **An agent on its own**: read [https://whizbrew.com/agents.md?a=62756b0d1f91](https://whizbrew.com/agents.md?src=body-text&a=62756b0d1f91). It asks for a free quote (`GET https://whizbrew.com/v1/agent/guide?goal=<the task in plain words>`), then one request (`POST https://whizbrew.com/v1/agent/start?a=62756b0d1f91`) gives it a key that works at once with the free credit, with no email and no sign-up form. Its human claims the account later.
- **A chat app** (ChatGPT, Claude, Gemini): add the MCP server `https://whizbrew.com/mcp` as a custom connector and sign in. No key to copy.
- **An agent with a shell** (Claude Code, Codex, Cursor): read [https://whizbrew.com/llms.txt?a=62756b0d1f91](https://whizbrew.com/llms.txt?src=body-text&a=62756b0d1f91). The agent starts a pairing with one request, its user approves with one click, and the agent holds its own key.
- **Plain HTTP**: create an account at [https://whizbrew.com/app#signup](https://whizbrew.com/app#signup), make a key, then `POST https://whizbrew.com/v1/call/<tool>` with `Authorization: Bearer <key>`.
