Overview

Search Reddit posts by keyword. Returns a list of posts matching the search query with metadata including title, vote count, comment count, and thumbnail image.

Inputs

| Field | Type | Required | Default | Description | |-------|------|----------|---------|-------------| | q | string | ✅ | web scraping | Search term to query posts | | sort | select | ❌ | relevance | Sort results by: relevance, hot, top, new, or comments | | time | select | ❌ | all | Time filter: all, year, month, week, day, or hour |

Response

Returns an array of post objects under the results key:

{
  "results": [
    {
      "image": "https://preview.redd.it/...",
      "date": "2024-01-15T10:30:00.000Z",
      "link": "Post Title Text",
      "votes": 1520,
      "comments": 87,
      "json": "{...tracking context data...}"
    }
  ]
}

Fields:

image — Thumbnail URL (if available)
date — Post creation timestamp
link — Post title text
votes — Upvote count
comments — Number of comments
json — Raw tracking metadata from Reddit

Auth & browser

Requires browser context. This endpoint uses a logged-in Reddit session via the browser. Ensure your browser is authenticated with Reddit before calling this endpoint.

Examples

Request inputs:

{
  "q": "web scraping",
  "sort": "hot",
  "time": "week"
}

Success response (excerpt):

{
  "results": [
    {
      "image": "https://external-preview.redd.it/...",
      "date": "2024-01-14T08:22:00.000Z",
      "link": "Best web scraping tools in 2024",
      "votes": 3241,
      "comments": 156,
      "json": "{\"origin\":\"...\",\"author\":\"...\"}"
    }
  ]
}

Notes

Returns posts across all subreddits matching the search term
Reddit's search may return limited results; pagination is handled automatically where supported
If the user is not logged in, results may be limited or unavailable
The json field contains Reddit's internal tracking data and can be ignored for most use cases
Rate limiting applies based on Reddit's standard limits for logged-in users