Reddit Search Scraper - Search Posts, Subreddits & Users

Overview

The Reddit Search Scraper runs Reddit keyword search across posts, subreddits, or users and returns structured JSON results. Add one or many queries, choose sort and time range for post search, and optionally pull comments for each matching post.

Built for social listening teams, researchers, SEOs, and product marketers who need repeatable Reddit search exports. Use it to discover conversations, communities, and accounts matching brand, competitor, or topic keywords — without manual scrolling.

Outputs clean, structured JSON with listing summaries plus optional nested comment rows when includeComments is enabled.

Features

• Multi-query batch search in one run
• Search types: posts, subreddits, users
• Post sort: relevance, hot, top, new, comments
• Time range filter for Top sort: hour → all
• Optional comment fetch per matching post with per-post comment caps
• Configurable result limits
• Type-tagged rows for posts, communities, users, comments, and errors
• Reliable pagination-backed collection

Use Cases

• Brand monitoring — Search brand and product names daily
• Competitor analysis — Track competitor mentions and sentiment threads
• Market research — Discover how buyers talk about a category
• Lead generation — Find posts asking for recommendations you can answer
• Content research — Source topics and FAQs for content calendars
• Trend monitoring — Compare query volumes and engagement over time
• Recruitment — Search for hiring or “looking for work” discussions
• AI training datasets — Build topic-scoped Reddit corpora
• Academic research — Export search hits for coding and analysis

Input

Parameter	Type	Required	Default	Description
queries	array of strings	Yes	—	Search keywords (one or more).
searchType	string	No	"posts"	posts, subreddits, or users.
sort	string	No	"relevance"	Post result order: relevance, hot, top, new, comments.
timeRange	string	No	"all"	Time window when sort is top: hour, day, week, month, year, all.
maxResults	string	No	"50"	Max results per query (numeric string).
includeComments	boolean	No	false	Fetch comments for each post result (extra API calls).
maxCommentsPerPost	string	No	"20"	Max comments per post when comments are enabled.

How parameters affect the run: searchType switches the endpoint family. sort / timeRange reshape post rankings. Enabling includeComments multiplies API usage by roughly one call per post.

Example input

{
  "queries": ["chatgpt alternatives", "notion vs obsidian"],
  "searchType": "posts",
  "sort": "top",
  "timeRange": "month",
  "maxResults": "40",
  "includeComments": true,
  "maxCommentsPerPost": "10"
}

Output

Rows vary by searchType. Shared listing fields:

Field	Type	Description
type	string	e.g. post, subreddit, user, comment, error
query	string	Query that produced the row
id	string | null	Entity ID
name	string | null	Fullname
kind	string | null	Reddit kind
title	string | null	Title / display title
author	string | null	Author when applicable
subreddit	string | null	Subreddit when applicable
score	number | null	Score
numComments	number | null	Comment count for posts
createdUtc	number | string | null	Created time
permalink	string | null	Permalink
url	string | null	URL
body	string | null	Text / description excerpt

Comment rows (when enabled) include parent post context fields from the same summary mapper. Error rows include error and optional page.

Example Output

{
  "type": "post",
  "query": "chatgpt alternatives",
  "id": "1jk4567",
  "name": "t3_1jk4567",
  "kind": "t3",
  "title": "What are the best ChatGPT alternatives in 2026?",
  "author": "saas_builder",
  "subreddit": "artificial",
  "score": 2104,
  "numComments": 387,
  "createdUtc": 1717000000,
  "permalink": "https://www.reddit.com/r/artificial/comments/1jk4567/what_are_the_best_chatgpt_alternatives_in_2026/",
  "url": "https://www.reddit.com/r/artificial/comments/1jk4567/what_are_the_best_chatgpt_alternatives_in_2026/",
  "body": "Looking for tools that are better for coding and long-context research..."
}

Related Scrapers

• Reddit Post Scraper — Full details for URLs found via search
• Reddit Comment Tree Scraper — Deep comment trees for top hits
• Reddit Popular Posts Scraper — Platform-wide trending without keywords
• Reddit Subreddit Posts Scraper — Ongoing monitoring inside known communities