scrollport

Search

Search public Reddit posts by query, sort and timeframe.

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

Example

You ask your agent

“Search Reddit for posts about agent tools from the past month.”

You get

Title
A public Reddit post
URL
https://www.reddit.com/r/MadeMeSmile/comments/w63dgy/example/
Community
MadeMeSmile
Score
220,403
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.search",
  "input": {
    "sort": "relevance",
    "limit": 5,
    "query": "agent tools",
    "timeframe": "month"
  }
}

Response

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

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

All inputs and outputs

Input

afterstring · optional

minLength: 1 · maxLength: 2048

limitinteger · optional

Maximum number of results to return.

minimum: 1 · maximum: 25

querystring · required

Search terms used to find relevant records.

minLength: 1 · maxLength: 200

sortstring · optional

Sort order for the results.

enum: relevance, new, top, comment_count

timeframestring · optional

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