Reddit Posts Search Scraper

Search Reddit posts globally or inside selected subreddits and get clean, flat, agent-friendly JSON. This actor is MCP optimized, perfect for SEO and AI agents, and built for social listening, trend discovery, market research, content research, competitor monitoring, and community analysis.

What it extracts

• Reddit post titles, bodies, authors, scores, upvote ratios, comment counts, flairs, domains, media URLs, permalinks, and timestamps
• Global Reddit search results for any keyword, phrase, brand, product, competitor, or pain point
• Optional subreddit-scoped search across one or many communities
• Optional compact top-comment previews embedded on each post record
• Source diagnostics so API users and AI agents can see whether data came from Reddit OAuth or a managed provider fallback

Input examples

Global Reddit search:

{
  "queries": ["AI search visibility", "best CRM for startups"],
  "sort": "relevance",
  "timeRange": "month",
  "maxPosts": 50,
  "includeTopComments": false
}

Search inside specific subreddits:

{
  "queries": ["AI search", "ChatGPT alternatives"],
  "subreddits": ["r/SEO", "r/marketing"],
  "sort": "top",
  "timeRange": "year",
  "maxPosts": 100,
  "includeTopComments": true,
  "maxTopCommentsPerPost": 3
}

Output shape

The dataset contains one recordType: "post" row per unique Reddit post. Rows are intentionally flat for spreadsheets, APIs, and AI agents. Top comments are included only when includeTopComments is enabled.

Example row:

{
  "recordType": "post",
  "postId": "1abc234",
  "subreddit": "r/SEO",
  "title": "How are you tracking AI search visibility?",
  "body": "Looking for tools and workflows...",
  "author": "u/example_user",
  "score": 128,
  "upvoteRatio": 0.92,
  "numComments": 41,
  "permalink": "https://www.reddit.com/r/SEO/comments/1abc234/how_are_you_tracking_ai_search_visibility/",
  "domain": "self.SEO",
  "postType": "text",
  "createdAt": "2026-06-10T12:00:00.000Z",
  "query": "AI search visibility",
  "sourceInput": "AI search visibility in r/SEO",
  "source": "reddit-oauth",
  "scrapedAt": "2026-06-11T10:00:00.000Z"
}

Input options

Option	Default	Description
queries	required	Keywords, phrases, brands, products, competitors, or topics to search
subreddits	empty	Optional subreddit names or URLs. Leave empty for global Reddit search
sort	relevance	relevance, new, top, comments, or hot
timeRange	month	hour, day, week, month, year, or all
maxPosts	100	Hard cap on unique posts returned and billed
includeTopComments	false	Adds compact top-comment previews to each post
maxTopCommentsPerPost	5	Maximum comment previews per post
postDateLimit	empty	Optional ISO date. Older posts are skipped after retrieval
includeNsfw	false	Include NSFW posts when intentionally needed

Data sources

The actor uses Reddit OAuth when REDDIT_CLIENT_ID and REDDIT_CLIENT_SECRET are configured. If OAuth is unavailable or returns no posts, it falls back to owner-managed ScrapeCreators and SociaVault keys when present. End users can also pass their own Reddit app credentials in the input.

Runs finish with a diagnostic RUN_SUMMARY and OUTPUT key-value record. Empty or blocked searches finish successfully with a clear warning instead of crashing, which makes the actor safer for scheduled monitors and MCP tool calls.

Pricing

• $0.002 per Reddit post returned
• Tiny actor-start event for platform usage accounting

Billing stops when maxPosts is reached. Duplicate posts across queries and subreddit scopes are deduplicated before billing.

Use from an AI agent

This actor is designed for MCP and natural-language tool calls. An AI agent can pass a plain topic like AI search visibility, optionally scope it to subreddits like r/SEO, and receive structured Reddit posts ready for summarization, lead research, sentiment analysis, or SEO content planning.

Notes

Reddit may restrict deleted, quarantined, private, banned, or geo-sensitive communities. This actor collects public Reddit content only. You are responsible for using the data in compliance with Reddit's Terms of Service, the Reddit User Agreement, applicable data-protection laws, and any rights of content authors. Do not use this data to identify, harass, or de-anonymize individuals.