Subreddit Posts

List a bounded page of public posts from one subreddit.

Capability: Reddit intent research
Current price: $0.0027/request
Availability: Ready to run

What this API does

Return bounded public posts from one subreddit with stable string IDs, canonical URLs, content, timestamps, engagement and an opaque next cursor. An optional documented cache age may produce an exact zero-credit cache hit.

Agents select this operation with tool ID reddit.subreddit-posts, then check its current inputs and price before a run.

Inputs and outputs

Input

afterstring · optional

Value supplied for after.

minLength: 1 · maxLength: 2048

cache_max_agestring · optional

Value supplied for cache max age.

enum: 1d, 3d, 7d, 14d, 30d

limitinteger · optional

Value supplied for limit.

minimum: 1 · maximum: 25

sortstring · optional

Value supplied for sort.

enum: best, hot, new, top, rising

subredditstring · required

Value supplied for subreddit.

minLength: 2 · maxLength: 21

timeframestring · optional

Accepted only with sort=top.

enum: all, day, week, month, year

Output

captured_atstring

Returned captured at value.

duplicate_itemsnumber

Returned duplicate items value.

itemsarray

Returned items value.

next_cursorstring

Returned next cursor value.

omitted_itemsnumber

Returned omitted items value.

Example request and output

Inspect returns this reviewed example, its estimated cost and the current input schema. Run calculates the estimate for your actual input.

Request

{
  "tool_id": "reddit.subreddit-posts",
  "input": {
    "sort": "new",
    "limit": 5,
    "subreddit": "SaaS"
  }
}

Output

{
  "items": [
    {
      "id": "1lfbo7u",
      "url": "https://www.reddit.com/r/SaaS/comments/1lfbo7u/example/",
      "title": "A public subreddit post",
      "community": "SaaS"
    }
  ],
  "captured_at": "2026-08-20T00:00:00.000Z",
  "next_cursor": "t3_next",
  "omitted_items": 0,
  "duplicate_items": 0
}

Errors and limitations

invalid_input: The route input was invalid or outside its public-read bounds.example: {"subreddit":"SaaS","sort":"new","limit":5}

Use Subreddit Posts with Scrollport

Get started

Use verified tools with pay-per-use pricing. Provider access is included. Tools that work in your own apps ask you to connect that account.

Connect your first agent to receive $1 trial credit.