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.
reddit_get_subreddit 4 credits: Get subreddit details.
reddit_get_subreddit_posts 4 credits: Get a subreddit's posts.
reddit_get_user 4 credits: Get a Reddit user.
reddit_get_post 4 credits: Get Reddit posts by id, with optional discussion thread.
reddit_resolve_url 2 credits: Identify a Reddit URL.

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

Quickstart#

1. Get a free key#

Terminal

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

One call returns a key (shown once) plus ready-made setup snippets. No account, no card. The CLI does this for you (npx @veezee/sdk init) and stores the key in ~/.veezee/config.

2. Call the API#

Terminal

curl "https://api.veezee.io/v1/reddit/subreddits?subreddit_name=selfhosted" \
  -H "Authorization: Bearer $VEEZEE_API_KEY"

The free key includes 200 credits per IP per day, recent data only. If you call without a key, the error response tells you exactly how to get one, so an agent recovers on its own in one round-trip.

3. Or connect over MCP#

MCP endpoint

https://mcp.veezee.io/reddit

transport: streamable-http, same free budget as REST. Claude Code, claude.ai, and other clients that support the MCP authorization spec open a browser sign-in automatically (email code, no password, no card, no key to copy). Other clients: put the key from step 1 in your MCP client's connection headers.

4. Need more than the free budget? Buy credits#

Pick a pack at /upgrade and pay: checkout credits the same key, so nothing needs reconfiguring.

Send the key as Authorization: Bearer <api_key> on every REST call, or in your MCP client's connection headers. Paid calls also send an Idempotency-Key header (any unique string per call) so a retried call is never billed twice.

What comes back#

reddit_search, subreddit, reddit_posts, reddit_user, reddit_thread, url_resolution. Full field lists: /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.

Other platforms: LinkedIn, X (formerly Twitter).

Reddit API for AI agents: /reddit-api-for-ai-agents.

Full tool reference: /docs.