Get Reddit posts by id, with optional discussion thread

Fetch full post content for up to 100 Reddit posts by their t3_ ids in one call -- the follow-up loop after reddit_search or reddit_get_subreddit_posts. Costs 4 credits for up to 10 ids, +1 credit per further 10 ids; every post comes back with its full body text. With exactly ONE id you may set detail to 'full' for +4 credits to also get the discussion tree (comments flattened in tree order with depth, about 200 per page, with a comments_cursor to continue), or pass comment_id (a t1_ id, also +4 credits) to fetch one specific comment in its post context. Post ids come from the other Reddit tools or from reddit_resolve_url on a post URL. Not for discovering posts; search first, then batch-fetch here.

get/v1/reddit/posts

Request

  • Base URL: https://api.veezee.io
  • URL: https://api.veezee.io/v1/reddit/posts
  • Auth: HTTP bearer

Query parameters

post_idsstring[] required

1 to 100 post ids with the t3_ prefix, e.g. ["t3_1tbups6"].

detail'concise' | 'full'

'full' adds the discussion tree; only valid with exactly one id, +4 credits.

comment_idstring

A t1_ comment id to fetch in context; only valid with exactly one post id, +4 credits like detail 'full'.

sort'best' | 'new' | 'top' | 'controversial' | 'old' | 'qa'

Discussion-tree order; only with detail 'full'.

cursorstring

comments_cursor from a previous detail='full' page.

freshness'recent' | 'realtime'

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_creditsinteger

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.

Headers

Idempotency-Keystring

Required on paid-key calls; free-tier trial-key calls do not need it. Unique key per logical call (UUID recommended). Reuse the SAME key when retrying the same call; a replay returns the stored result without charging again. Reusing a key with different arguments returns IDEMPOTENCY_KEY_REUSED.

Response

reddit_thread envelope (schema_version 2)

entity'reddit_thread' required
platform'linkedin' | 'reddit' | 'x' nullable required
canonical_urlstring nullable required
data_as_ofstring nullable required
schema_version'2' required
platform_fieldsobject required

Changes

No recorded changes to this operation across all 1 revision of this API.