# Reddit - Veezee docs

Reddit's wedge is discussions and comment-level sentiment: what people actually say about a product, problem, or brand, straight from the comments.

## Tools

- **reddit_search** (6 credits): Search Reddit posts, comments, subreddits, or users. [/docs/tools/reddit_search](https://veezee.io/docs/tools/reddit_search)
- **reddit_get_subreddit** (4 credits): Get subreddit details. [/docs/tools/reddit_get_subreddit](https://veezee.io/docs/tools/reddit_get_subreddit)
- **reddit_get_subreddit_posts** (4 credits): Get a subreddit's posts. [/docs/tools/reddit_get_subreddit_posts](https://veezee.io/docs/tools/reddit_get_subreddit_posts)
- **reddit_get_user** (4 credits): Get a Reddit user. [/docs/tools/reddit_get_user](https://veezee.io/docs/tools/reddit_get_user)
- **reddit_get_post** (4 credits): Get Reddit posts by id, with optional discussion thread. [/docs/tools/reddit_get_post](https://veezee.io/docs/tools/reddit_get_post)
- **reddit_resolve_url** (2 credits): Identify a Reddit URL. [/docs/tools/reddit_resolve_url](https://veezee.io/docs/tools/reddit_resolve_url)

`get_usage` checks balance and works the same way across every platform: free, 0 credits. https://veezee.io/docs/tools/get_usage

## Quickstart

### 1. Call it, no key

```
curl "https://api.veezee.io/v1/reddit/subreddits?subreddit_name=selfhosted"
```

No signup, no card, no key. Keyless calls run under a shared budget of 20 credits per IP per day, recent data only, no realtime, no `Idempotency-Key` needed.

### 2. Or connect over MCP, no key

```
https://mcp.veezee.io/reddit
```

transport: streamable-http, same keyless budget as REST.

### 3. Hit the daily cap? Buy a key

The error names `upgrade_url`: https://veezee.io/upgrade. Pick a pack, pay, and your API key is shown once on the confirmation page. Send it as `Authorization: Bearer <api_key>` on every REST call (plus an `Idempotency-Key` header on metered routes), or add it to your MCP client's connection headers. That checkout is the only human step in the product.

## What comes back

[reddit_search](https://veezee.io/docs/fields#reddit_search), [subreddit](https://veezee.io/docs/fields#subreddit), [reddit_posts](https://veezee.io/docs/fields#reddit_posts), [reddit_user](https://veezee.io/docs/fields#reddit_user), [reddit_thread](https://veezee.io/docs/fields#reddit_thread), [url_resolution](https://veezee.io/docs/fields#url_resolution). Full field lists: https://veezee.io/docs/fields

## Limits

- No server-side time window on comment search: filter results on created_at yourself, and poll with sort=new for monitoring.
- Discover result depth caps around a few hundred results per query; decompose a broad topic into several narrower queries instead of one wide one.
- Cached search results refresh on a 20-minute cycle: polling faster than that just replays the same page.

Full tool reference: https://veezee.io/docs