scrollport

Subreddit Posts

Reddit

List a bounded page of public posts from one subreddit.

Capability
Reddit intent research
Current price
$0.0027/call
Availability
Ready to run
Last accepted verification

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 inspect its current executable contract before a run.

Public input and output shape

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

This reviewed worked example is shared with inspect. Inspect also returns the current executable schema and price estimate before a paid run.

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
}
Teaching errors and limitations
  • invalid_input: The route input was invalid or outside its public-read bounds.example: {"subreddit":"SaaS","sort":"new","limit":5}
Updated
21 August 2026

Use Subreddit Posts with Scrollport

Use Scrollport

Scrollport identifies and validates the best-in-class API tools and provides them on a pay-as-you-go basis so you don't need to maintain a separate provider account, subscription or credits.

Give your agent the setup prompt to receive $1 in trial credit and start using the tools right away.