# Subreddit Posts

Reddit

List a bounded page of public posts from one subreddit.

## Use this tool with your AI agent

1. Copy the prompt
2. Paste it into your agent
3. 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.

**Already connected:** Your agent can use that connection.

**New user:** Your agent will guide you through setup, sign-in and authorisation.

Provider access is included.

Connect your first agent to receive $1 trial credit.

**Job:** [Search Reddit](https://scrollport.com/tools/reddit-api)

**Current price:** $0.0027/request

**Availability:** Ready to run

## Tool 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.

**Inputs and outputs**

### Input

`after` string · optional

Value supplied for after.

minLength: 1 · maxLength: 2048

`cache_max_age` string · optional

Value supplied for cache max age.

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

`limit` integer · optional

Value supplied for limit.

minimum: 1 · maximum: 25

`sort` string · optional

Value supplied for sort.

enum: best, hot, new, top, rising

`subreddit` string · required

Value supplied for subreddit.

minLength: 2 · maxLength: 21

`timeframe` string · optional

Accepted only with sort=top.

enum: all, day, week, month, year

### Output

`captured_at` string

Returned captured at value.

`duplicate_items` number

Returned duplicate items value.

`items` array

Returned items value.

`next_cursor` string

Returned next cursor value.

`omitted_items` number

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}

---

Canonical page: https://scrollport.com/tools/providers/reddit/subreddit-posts