Subreddit posts API 4 credits

Read any subreddit's feed programmatically: one page of posts as structured JSON, in the community's own front-page order by default, or sort=new for monitoring loops that poll and diff. Reddit splices promoted posts into feeds; include_promoted controls whether they appear.

Each page costs 4 credits; a cursor page is a new call priced the same way.

Try it now#

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

Terminal

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

Request

curl "https://api.veezee.io/v1/reddit/subreddit-posts?subreddit_name=webdev&sort=new" \
  -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_subreddit_posts:

tools/call

{
  "method": "tools/call",
  "params": {
    "name": "reddit_get_subreddit_posts",
    "arguments": {
      "subreddit_name": "webdev",
      "sort": "new"
    }
  }
}

Parameters#

Param	Required	Type	Description
`subreddit_name`	yes	`string`	Subreddit name without the r/ prefix, e.g. 'selfhosted'.
`sort`	no	`string`	Defaults to the subreddit's front-page order.
`range`	no	`string`	Required with sort=top or controversial, but currently not applied upstream on this feed (results are all-time).
`include_promoted`	no	`boolean`	Keep the promoted ads Reddit splices into the feed (marked is_promoted). Default drops them.
`cursor`	no	`string`	Cursor from a previous page for older posts.
`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_posts envelope. Full field list: /docs/fields#reddit_posts.

Pricing#

reddit_get_subreddit_posts costs 4 credits base per call (surcharges for optional sections, cursor pages, and batches are in the full reference). 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#

Can I get top posts of the week?

Known gap, stated honestly: on this feed sort=top currently returns all-time top regardless of range. For time-windowed queries use reddit_search, whose range does work.

Several subreddits in one call?

One per call; loop client-side.

How do I read comments on a post I found?

Its t3_ id goes to the Reddit thread API.