# Search

Reddit

Search public Reddit posts by query, sort and timeframe.

## 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 Search (tool ID: reddit.search). 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 one bounded, deduplicated page of public Reddit posts with stable string IDs, canonical URLs, text, community, timestamps, engagement and an opaque next cursor.

**Inputs and outputs**

### Input

`after` string · optional

Value supplied for after.

minLength: 1 · maxLength: 2048

`limit` integer · optional

Value supplied for limit.

minimum: 1 · maximum: 25

`query` string · required

Search terms used to find relevant records.

minLength: 1 · maxLength: 200

`sort` string · optional

Value supplied for sort.

enum: relevance, new, top, comment_count

`timeframe` string · optional

Value supplied for timeframe.

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.search",
  "input": {
    "sort": "relevance",
    "limit": 5,
    "query": "agent tools",
    "timeframe": "month"
  }
}
```

### Output

```
{
  "items": [
    {
      "id": "w63dgy",
      "url": "https://www.reddit.com/r/MadeMeSmile/comments/w63dgy/example/",
      "title": "A public Reddit post",
      "community": "MadeMeSmile",
      "engagement": {
        "score": 220403
      }
    }
  ],
  "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: {"query":"agent tools","sort":"relevance","timeframe":"month","limit":5}

---

Canonical page: https://scrollport.com/tools/providers/reddit/search