Reddit Search Post Scraper

Scrapes Reddit search results for posts, extracting comprehensive data without requiring login. Useful for content research, sentiment analysis, market research, and data collection for academic or AI training purposes.

Key Features

• No Authentication: Runs without a Reddit account.
• Comprehensive Data: Extracts 30+ fields per post, including content (text, markdown, HTML), author info, subreddit details, and engagement metrics.
• Flexible Search: Supports sorting (relevance, hot, top, new, comments) and time filtering (hour, day, week, month, year, all-time).
• Content Control: Option to include or exclude NSFW content.
• Auto-Pagination: Automatically fetches multiple pages of results up to the specified limit.

How to Use

Configure the actor with input parameters via JSON. Here are common examples:

Basic Search:

{
  "query": "artificial intelligence",
  "sort": "relevance",
  "time": "all",
  "nsfw": false,
  "maxResults": 25
}

Top Posts from Past Week:

{
  "query": "technology news",
  "sort": "top",
  "time": "week",
  "maxResults": 50
}

Latest Discussions:

{
  "query": "climate change",
  "sort": "new",
  "time": "day",
  "maxResults": 100
}

Input Parameters

Output Format

The actor outputs an array of items, where each item is a detailed JSON object for a single Reddit post. Key output fields include:

• Post Identifiers: postId, postTitle, url, permalink.
• Content: contentPreview, contentMarkdown, contentHtml.
• Subreddit Data: subredditName, subredditSubscribers, subredditIsNsfw, subredditType.
• Author Data: authorName, authorIcon, authorIsCakeDay.
• Engagement Metrics: score, upvoteRatio, commentCount.
• Metadata: Post flair, timestamps, locked/archived status, and media/thumbnail URLs when available.

Example output snippet:

{
  "postId": "t3_x56f42",
  "postTitle": "Example Post Title",
  "url": "https://www.reddit.com/r/privacy/comments/x56f42/...",
  "subredditName": "privacy",
  "subredditSubscribers": 1543277,
  "authorName": "Level-Monk6085",
  "score": 189,
  "upvoteRatio": 87.06,
  "commentCount": 166
  // ... additional fields
}