# Reddit search API - Veezee

Search all of Reddit by keyword through one endpoint. `type` picks the target: posts (default), comments (what people actually say, see the [Reddit comments API](https://veezee.io/reddit-comments-api)), subreddits, or users. Posts sort by relevance, top, new, hot, or comment count, with a time range from past hour to all time.

Each page costs 6 credits. Result depth per query is capped upstream around a few hundred results, so decompose broad topics into several narrower queries rather than paging one giant one.

## Try it now

No account, no card: mint a free key in one call, then call the endpoint.

```
curl -s -X POST https://api.veezee.io/v1/keys/mint
```

```
curl "https://api.veezee.io/v1/reddit/search?query=best+crm+for+freelancers&type=posts" \
  -H "Authorization: Bearer $VEEZEE_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"
```

## Over MCP

Point an MCP client at `https://mcp.veezee.io/reddit` (streamable-http; `https://mcp.veezee.io/all` serves every platform over one connection) and call `reddit_search`:

```json
{
  "method": "tools/call",
  "params": {
    "name": "reddit_search",
    "arguments": {
      "query": "best crm for freelancers",
      "type": "posts"
    }
  }
}
```

## Parameters

| Param | Required | Type | Description |
| --- | --- | --- | --- |
| `query` | yes | `string` | Free-text keywords, e.g. 'self hosted photo backup'. Not a URL; use reddit_resolve_url for URLs. |
| `type` | no | `string` | What to search. 'comments' finds mentions inside discussions; 'subreddits' finds communities. |
| `sort` | no | `string` | posts: any value; comments: relevance|top|new; invalid for subreddits and users. |
| `range` | no | `string` | Time window. posts only. |
| `cursor` | no | `string` | Cursor from a previous page. |
| `freshness` | no | `string` | recent (default) serves cached data from the last few hours when available; realtime forces a live fetch for +2 credits (refunded if we fall back to cached data). Trial keys are cached-only and reject realtime with TRIAL_CAP_EXCEEDED; paying upgrades this same key to unlock it. |
| `max_credits` | no | `integer` | Spend ceiling for this one call. The call is rejected (nothing charged) if its quote exceeds this. Only the quote is ever reserved, never this ceiling. |

Returns a `reddit_search` envelope. Full field list: https://veezee.io/docs/fields#reddit_search

## Pricing

`reddit_search` costs 6 credits base per call (surcharges for optional sections, cursor pages, and batches: https://veezee.io/docs/tools/reddit_search). Every key starts with a free budget of 200 credits per IP per day, no account, no card; past that, credits are $2.00 per 1,000 with no subscription required.

## FAQ

**Does the time range work on comments?**

No: `range` applies to posts only (INVALID_INPUT elsewhere). Comments sort by relevance, top, or new; filter created_at client-side.

**How do I read a result's full discussion?**

Take the post's t3_ id to the [Reddit thread API](https://veezee.io/reddit-thread-api) with `detail=full` for the whole comment tree.

**How deep can I paginate?**

Follow the cursor; each page is a new 6 credits call, and depth per query caps upstream around a few hundred results.

## Read next

- [reddit_search: the full reference](https://veezee.io/docs/tools/reddit_search)
- [Brand monitoring recipe](https://veezee.io/use-cases/brand-monitoring)
- [Reddit API for AI agents](https://veezee.io/reddit-api-for-ai-agents)
- [Pricing](https://veezee.io/pricing)