Reddit Search Scraper

Search Reddit for any keyword or phrase and extract matching posts with full engagement data — upvotes, comment counts, post body, author, subreddit, and more.

Built for brand monitoring, lead generation, competitor analysis, and market research. No browser, no proxies, near-zero failure rate.

---

What This Actor Does

Enter a search query (and optionally a target subreddit) and this actor returns a clean dataset of Reddit posts matching your search. Results include post metadata, engagement metrics, and body text — ready to feed into spreadsheets, CRMs, or downstream automations.

Use cases:

• Monitor Reddit for mentions of your brand, product, or competitors
• Find communities discussing problems your product solves (for lead generation)
• Research sentiment and language around a topic before launching a campaign
• Track trending discussions in a niche subreddit
• Identify high-engagement posts for content inspiration

---

Inputs

Field	Required	Description
Search Query	✅ Yes	Keyword or phrase to search (e.g. "notion alternative", "best CRM for startups")
Subreddit	No	Restrict to one subreddit (e.g. entrepreneur). Leave blank to search all of Reddit.
Sort Order	No	relevance (default), new, top, comment_count. Use hot only with a subreddit.
Timeframe	No	all (default), year, month, week, day, hour
Max Results	No	How many posts to return, up to 500. Default: 10.
Include Body Text	No	Include the full post text where available. Default: true.
Minimum Score	No	Filter out posts below this upvote score. Default: 0 (no filter).
Minimum Comments	No	Filter out posts with fewer than this many comments. Default: 0 (no filter).

Subreddit name format: Use bare name only — entrepreneur, not r/entrepreneur or a full URL. The actor strips any r/ prefix automatically.

---

Example Inputs

Global search across all of Reddit:

{
  "query": "best CRM for small business",
  "sort": "top",
  "timeframe": "year",
  "maxResults": 50,
  "minScore": 10,
  "minComments": 5
}

Scoped to a specific subreddit:

{
  "query": "Notion vs Obsidian",
  "subreddit": "productivity",
  "sort": "hot",
  "timeframe": "month",
  "maxResults": 25,
  "includeBodyText": false
}

---

Example Output

Global search — fields from /v1/reddit/search:

[
  {
    "id": "w63dgy",
    "title": "Player realizes that he nearly stole the dogs job",
    "author": "Morgentau7",
    "subreddit": "MadeMeSmile",
    "url": "https://www.reddit.com/r/MadeMeSmile/comments/w63dgy/player_realizes_that_he_nearly_stole_the_dogs_job/",
    "score": 220403,
    "upvoteRatio": 0.97,
    "numComments": 1246,
    "createdAt": "2022-07-23T14:35:00.000Z",
    "isVideoPost": true,
    "permalink": "/r/MadeMeSmile/comments/w63dgy/",
    "subredditSubscribers": 11605207,
    "bodyText": null,
    "searchQuery": "dogs at work",
    "searchSubreddit": null,
    "scrapedAt": "2026-04-04T08:45:00.000Z"
  }
]

Subreddit search — fields from /v1/reddit/subreddit/search:

[
  {
    "id": "t3_8gmjrb",
    "title": "Is doing 50-100 pushups a day doing anything?",
    "author": null,
    "subreddit": "Fitness",
    "url": "https://www.reddit.com/r/Fitness/comments/8gmjrb/is_doing_50100_pushups_a_day_doing_anything/",
    "score": 1414,
    "upvoteRatio": null,
    "numComments": 582,
    "createdAt": "2018-05-03T01:09:17.620Z",
    "isNsfw": false,
    "isSpoiler": false,
    "isCrosspost": false,
    "thumbnail": null,
    "permalink": "/r/Fitness/comments/8gmjrb/is_doing_50100_pushups_a_day_doing_anything/",
    "bodyText": null,
    "searchQuery": "pushups",
    "searchSubreddit": "Fitness",
    "scrapedAt": "2026-04-04T08:45:01.000Z"
  }
]

Note: Global and subreddit searches return slightly different fields because they use different API endpoints. upvoteRatio is only available from global search; isNsfw, isSpoiler, and isCrosspost are only available from subreddit search.

---

Quality Filters

Use minScore and minComments to cut through low-quality posts and focus on discussions that have actually resonated with the Reddit community.

• minScore: 50 — only posts that got real upvotes
• minComments: 10 — only posts that sparked conversation

These filters run client-side after retrieval, so they don't affect the number of API calls made.

---

Pricing

This actor uses a pay-per-event (PPE) model at $0.50 per 100 results returned. You only pay for results that make it into your dataset after all filters are applied.

---

Store Description (150 words)

Search Reddit for any keyword and extract posts with full engagement data — upvotes, comments, body text, author, subreddit, and more. Built for brand monitoring, lead generation, competitor analysis, and market research.

Enter a query, choose your sort order, and optionally scope results to a single subreddit. Use the minimum score and comment filters to surface only high-quality, high-engagement discussions. Get back a clean, structured dataset ready for spreadsheets, CRMs, or automation pipelines.

No proxies needed, no browser overhead, near-zero failure rate. Results include post ID, title, author, URL, upvote ratio, comment count, creation date, body text, and flair — all in a consistent JSON schema.

Ideal for SaaS founders researching pain points, marketers tracking brand mentions, agencies monitoring competitors, and researchers mapping Reddit discourse at scale.

Category tags: social-media · reddit · lead-generation · market-research

---

Setup Instructions for Apify Console

1. Create the Actor

• Go to Actors → Develop → Create new
• Select Empty Node.js template
• Name it reddit-search-scraper

2. Enter the Files

Use the code editor sidebar to create/overwrite these files:

File	Where in editor
src/main.js	src/ folder
package.json	root
.actor/actor.json	.actor/ folder
.actor/input_schema.json	.actor/ folder

3. Set the Environment Variable

• Go to Actor settings → Environment variables
• Add: SCRAPECREATORS_API_KEY = <your key>
• Mark it as Secret

This keeps the API key out of source code and invisible to users.

4. Memory & Runtime

• Minimum memory: 128 MB (sufficient)
• Runtime: Node.js 18
• No special build commands needed

5. Test Run

Paste this input and verify the dataset has records:

{
  "query": "best project management tool",
  "sort": "relevance",
  "maxResults": 10
}

6. Publish to Store

• Pricing: PPE — $0.50 per 100 results
• Description: use the 150-word block above
• Tags: social-media, reddit, lead-generation, market-research
• Set visibility to Public