reddit_get_subreddit_posts 4 credits

Fetch one page of posts from a single subreddit, the community-monitoring primitive. subreddit_name is the name without the r/ prefix. sort defaults to the subreddit's own front-page order (best); use sort=new for monitoring. sort=top and controversial need a range, but the window is currently not applied upstream on this feed: top returns the subreddit's all-time top posts whatever range says (time-windowed tops are a known gap here; reddit_search's range DOES work for keyword queries). Costs 4 credits per page; a cursor page is a NEW call priced the same way. Reddit splices about one promoted ad into every feed page; these are dropped by default, so set include_promoted=true only when ads ARE the data you want (ad intelligence, who targets this community) -- kept ads carry is_promoted=true. Returns post summaries (title, author, upvotes, comment_count, created_at, permalink, id) with a cursor for older posts; bodies and discussions come from reddit_get_post with the returned ids. For keyword search across all of Reddit use reddit_search; this tool takes no query.

Part of the Reddit toolset: /docs/reddit.

Parameters#

REST#

GET /v1/reddit/subreddit-posts · auth: required · metered: true

curl "https://api.veezee.io/v1/reddit/subreddit-posts?subreddit_name=selfhosted&sort=new" \
  -H "Authorization: Bearer $VEEZEE_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"

MCP#

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

Input examples#

Monitor a community for new posts

{
  "subreddit_name": "selfhosted",
  "sort": "new"
}

All-time top posts

{
  "subreddit_name": "programming",
  "sort": "top",
  "range": "all_time"
}

Ad intelligence: who advertises to this community

{
  "subreddit_name": "programming",
  "include_promoted": true
}

Output#

Returns a reddit_posts envelope. Full field list: /docs/fields#reddit_posts.

Errors#

REST returns application/problem+json; MCP returns the same content as an error result. message is written as the next-turn instruction.