# Reddit thread API - Veezee

When search surfaces a thread worth reading, this call fetches the post's full body and, with `detail=full`, the entire discussion tree: comments flattened in tree order with depth, about 200 per page, with a cursor to continue. It also batches: full text for up to 100 posts by their t3_ ids in one call.

Batch pricing starts at 4 credits for up to 10 ids; `detail=full` works with exactly one id and adds 4 credits.

## 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/posts?post_ids=t3_1tbups6&detail=full" \
  -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_get_post`:

```json
{
  "method": "tools/call",
  "params": {
    "name": "reddit_get_post",
    "arguments": {
      "post_ids": [
        "t3_1tbups6"
      ],
      "detail": "full"
    }
  }
}
```

## Parameters

| Param | Required | Type | Description |
| --- | --- | --- | --- |
| `post_ids` | yes | `array` | 1 to 100 post ids with the t3_ prefix, e.g. ["t3_1tbups6"]. |
| `detail` | no | `string` | 'full' adds the discussion tree; only valid with exactly one id, +4 credits. |
| `comment_id` | no | `string` | A t1_ comment id to fetch in context; only valid with exactly one post id, +4 credits like detail 'full'. |
| `sort` | no | `string` | Discussion-tree order; only with detail 'full'. |
| `cursor` | no | `string` | comments_cursor from a previous detail='full' 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_thread` envelope. Full field list: https://veezee.io/docs/fields#reddit_thread

## Pricing

`reddit_get_post` costs 4 credits base per call (surcharges for optional sections, cursor pages, and batches: https://veezee.io/docs/tools/reddit_get_post). 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

**Where do post ids come from?**

reddit_search, reddit_get_subreddit_posts, or the [URL resolver](https://veezee.io/reddit-url-resolver); they're the t3_ values.

**Can I fetch one specific comment?**

Pass its t1_ id as comment_id (4 credits extra) to get that comment in its post context.

**Does one call return the whole tree?**

About 200 comments per page in tree order; follow comments_cursor for the rest.

## Read next

- [reddit_get_post: the full reference](https://veezee.io/docs/tools/reddit_get_post)
- [Reddit API for AI agents](https://veezee.io/reddit-api-for-ai-agents)
- [Pricing](https://veezee.io/pricing)