scrollport

Subreddit Posts

List a bounded page of public posts from one subreddit.

by RedditReady to run$0.0027 per request · $0.27 per 100 requests

Example

You ask your agent

“Show me the newest posts in r/SaaS.”

You get

Title
A public subreddit post
URL
https://www.reddit.com/r/SaaS/comments/1lfbo7u/example/
Community
SaaS
What your agent sends and gets back (JSON)

Your agent works out the exact inputs, such as IDs, dates and settings, from what you ask.

Request

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

Response

{
  "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
}

Use it with your agent

Copy the prompt and paste it into your agent, then tell it what you need.

Read https://scrollport.com/start. Use my existing Scrollport connection, or help me connect if needed. Help me use Subreddit Posts (tool ID: reddit.subreddit-posts). Ask me for the details you need, then show me the result.

Provider access is included. If your agent isn't connected to Scrollport yet, it will help you set that up.

Other tools for this job

Compare all 16 →

Questions

Is Subreddit Posts by Reddit free?

Scrollport has no free tier: it costs $0.0027 per request ($0.27 per 100 requests), paid per use from a prepaid wallet with no subscription. Connecting your first agent adds $1 of trial credit, so you can try it before adding funds.

Do I need an API key from Reddit?

No. Your agent runs it through your Scrollport connection (MCP, the Scrollport CLI or the HTTP API), and Scrollport handles access to Reddit, so you don't sign up with Reddit or manage an API key.

Details

About this tool

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.

All inputs and outputs

Input

afterstring · optional

minLength: 1 · maxLength: 2048

cache_max_agestring · optional

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

limitinteger · optional

Maximum number of results to return.

minimum: 1 · maximum: 25

sortstring · optional

Sort order for the results.

enum: best, hot, new, top, rising

subredditstring · required

minLength: 2 · maxLength: 21

timeframestring · optional

Accepted only with sort=top.

enum: all, day, week, month, year

Output

captured_atstring

When the data was retrieved.

duplicate_itemsnumber

Number of duplicate items removed.

itemsarray

Result records.

next_cursorstring

Cursor to pass for the next page; absent when there are no more results.

omitted_itemsnumber

Number of items left out of the response.

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