🔍 Reddit Search Post Scraper

Search and scrape Reddit posts with comprehensive data extraction. Get post content, author info, subreddit details, engagement metrics, media URLs, and more. Perfect for content research, sentiment analysis, and data collection.

📋 Table of Contents

• 🚀 Features
• 🎯 Use Cases
• ⚡ Quick Start
• 📊 Input Parameters
• 📤 Output Format
• Best Practices
• ❓ FAQ

🚀 Features

• ✅ No Login Required - Search Reddit without authentication
• ✅ Comprehensive Data - Extract 30+ fields per post
• ✅ Advanced Filters - Sort by relevance, hot, top, new, or comments
• ✅ Time Range - Filter by hour, day, week, month, year, or all-time
• ✅ NSFW Control - Include or exclude adult content
• ✅ Auto Pagination - Automatically fetch multiple pages until limit
• ✅ Post Content - Get markdown, HTML, and text preview
• ✅ Subreddit Info - Name, subscribers, type, and NSFW status
• ✅ Author Data - Username, profile icon, and cake day status
• ✅ Engagement Metrics - Score, upvote ratio, comments, and views
• ✅ Media URLs - Thumbnails and media links when available
• ✅ Post Metadata - Flair, timestamps, locked/archived status

🎯 Use Cases

• 📊 Sentiment Analysis - Analyze public opinion on topics
• 🎓 Academic Research - Collect data for social media studies
• 📈 Trend Analysis - Track trending topics and discussions
• 💼 Market Research - Understand audience preferences and behavior
• 📢 Brand Monitoring - Track brand mentions and reputation
• 🔍 Content Discovery - Find relevant posts for your niche
• � Social Listening - Monitor conversations and feedback
• 🤖 AI Training Data - Collect text data for machine learning

⚡ Quick Start

1️⃣ Basic Search

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

2️⃣ Top Posts from Past Week

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

3️⃣ Latest Discussions

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

📊 Input Parameters

Parameter	Type	Required	Default	Description
query	String	✅	-	Search query (1-300 characters)
sort	String	❌	relevance	Sort: relevance, hot, top, new, comments
time	String	❌	all	Time: all, year, month, week, day, hour
nsfw	Boolean	❌	false	Include NSFW content
maxResults	Integer	❌	25	Max posts: 1-100 (auto-pagination)

Sort Options

• relevance - Most relevant to query
• hot - Currently trending
• top - Highest rated
• new - Latest posts
• comments - Most discussed

Time Filters

• all - All time
• year - Past 12 months
• month - Past 30 days
• week - Past 7 days
• day - Past 24 hours
• hour - Past 60 minutes

📤 Output Format

Each post contains 30+ fields with comprehensive data:

{
  "postId": "t3_x56f42",
  "postTitle": "Please tell me how I can delete DELETED pictures from my phone",
  "url": "https://www.reddit.com/r/privacy/comments/x56f42/...",
  "permalink": "https://reddit.com/r/privacy/comments/x56f42/...",
  "contentPreview": "I am in a lot of trouble right now and I need help...",
  "contentMarkdown": "Full markdown content...",
  "contentHtml": "Full HTML content...",
  "subredditId": "t5_2qhlc",
  "subredditName": "privacy",
  "subredditPrefixedName": "r/privacy",
  "subredditTitle": "Privacy in the digital age",
  "subredditSubscribers": 1543277,
  "subredditIsNsfw": false,
  "subredditType": "PUBLIC",
  "authorId": "t2_pfuj49vx",
  "authorName": "Level-Monk6085",
  "authorIcon": "https://styles.redditmedia.com/...",
  "authorIsCakeDay": false,
  "score": 189,
  "upvoteRatio": 87.06,
  "commentCount": 166,
  "viewCount": null,
  "createdAt": "2022-09-03T22:17:42.128000+0000",
  "editedAt": "2022-09-04T21:01:48.903000+0000",
  "isNsfw": false,
  "isSpoiler": false,
  "isLocked": false,
  "isArchived": true,
  "isStickied": false,
  "isGildable": true,
  "isSelfPost": true,
  "flair": "discussion",
  "flairType": "text",
  "flairBackgroundColor": "#DADADA",
  "flairTextColor": "DARK",
  "mediaType": "Text",
  "hasMedia": false,
  "thumbnail": null,
  "mediaUrl": null,
  "mediaDownloadUrl": null,
  "mediaStreamingUrl": null,
  "domain": "self.privacy",
  "postHint": null,
  "distinguishedAs": null,
  "scrapedAt": "2025-11-30T15:30:00.000Z"
}

Key Fields

Category	Fields
Post	postId, postTitle, url, permalink, contentPreview, contentMarkdown, contentHtml
Subreddit	subredditName, subredditSubscribers, subredditType, subredditIsNsfw
Author	authorName, authorIcon, authorIsCakeDay
Engagement	score, upvoteRatio, commentCount, viewCount
Metadata	createdAt, editedAt, flair, isNsfw, isSpoiler, isLocked, isArchived
Media	mediaType, hasMedia, thumbnail, mediaUrl, mediaDownloadUrl

Best Practices

1. Use specific queries - More targeted searches yield better results
2. Choose appropriate sort - Use 'top' for popular content, 'new' for latest
3. Set time ranges - Filter by time period for relevant results
4. Start small - Test with 25-50 posts before scaling up
5. Use dataset views - Apify provides 4 table views (Overview, Detailed, Engagement, Media)
6. Handle pagination - Actor automatically paginates until maxResults

Important Notes

• ✅ No Reddit login required
• ✅ Extracts all post types (text, image, video, link)
• ✅ Automatic pagination support
• ⚠️ Maximum 100 posts per run
• ⚠️ Deleted posts show [deleted] as author

❓ FAQ

Q: Do I need a Reddit account?
A: No! Works without any login or authentication.

Q: How many posts can I scrape?
A: Up to 100 posts per run with automatic pagination.

Q: What data is extracted?
A: 30+ fields including post content, author info, subreddit details, engagement metrics, and media URLs.

Q: Can I search specific subreddits?
A: Actor searches all subreddits. Include subreddit name in query for better targeting (e.g., "AI r/technology").

Q: Are media URLs included?
A: Yes! Thumbnails and media URLs are extracted when available.

Q: How fast is the scraper?
A: Typically 3-8 seconds per page. Pagination adds ~1 second delay between pages.

Q: Is this legal?
A: Yes, scrapes publicly available Reddit content. Follow Reddit's Terms of Service and use responsibly.

---

🚀 Get Started Now

Ready to search Reddit and download media content?

1. Click "Try for free" to test the actor
2. Enter your search query and configure filters
3. Get comprehensive media data with direct download links

⭐ If this actor helps your workflow, please give it a star!

---

Related Actors 🤝

• Reddit User Data Scraper - Extract user profiles and post history
• Reddit Search Scraper - Search Reddit posts by keywords
• Reddit Comments Scraper – extract comments from specific threads.
• Reddit Post Viewer – fetch detailed data for individual Reddit posts.

---

🏷️ Tags

reddit scraper reddit search reddit api reddit data extraction reddit post scraper reddit content scraper reddit automation reddit data mining reddit trend analysis reddit sentiment analysis reddit research reddit posts apify reddit reddit dataset

---

Disclaimer: Scrapes publicly available Reddit content only. Users must comply with Reddit's Terms of Service. Use responsibly and ethically.