Back to Search Reddit

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.

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

afterstring · optional

Value supplied for after.

minLength: 1 · maxLength: 2048

limitinteger · optional

Value supplied for limit.

minimum: 1 · maximum: 25

querystring · required

Search terms used to find relevant records.

minLength: 1 · maxLength: 200

sortstring · optional

Value supplied for sort.

enum: relevance, new, top, comment_count

timeframestring · optional

Value supplied for timeframe.

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.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}