Reddit Posts Search Scraper 🔍

Extract Reddit posts from search results with comprehensive metadata and advanced filtering capabilities.

🌟 Features

• Search and extract posts from Reddit search results
• Support for multiple content types (text, images, videos, galleries)
• Advanced sorting options (relevance, top, new, comments, hot)
• Time-based filtering (hour, day, week, month, year, all)
• Safe search toggle
• Configurable maximum items limit

📊 Output Data Structure

Each scraped post includes:

• Post ID and metadata
• Subreddit information and icon
• Author ID
• Creation timestamp (ISO format)
• Post title and URL
• Content type and media details
• Engagement metrics (score, votes, comments)
• Content flags (NSFW, spoiler, archived)

💡 Use Cases

• Content research and analysis
• Trend monitoring
• Market research
• Community engagement tracking
• Social media analytics
• Academic research
• Competitive analysis
• Content curation

🔧 Input Parameters

Parameter	Type	Description
query	String	Search keyword or phrase
sort	String	Sort results by: 'relevance', 'top', 'new', 'comments', or 'hot'
time	String	Time range filter: 'hour', 'day', 'week', 'month', 'year', or 'all'
safeSearch	String	Enable/disable safe search ('0' for safe, '1' for unsafe)
maxItems	Integer	Maximum number of items to scrape

Input Example

A full explanation of an input example in JSON.

1{
2    "query": "ai",
3    "sort": "relevance",
4    "time": "all",
5    "safeSearch": "0",
6    "maxItems": 45
7}

Output sample

The results will be wrapped into a dataset which you can always find in the Storage tab. Here's an excerpt from the data you'd get if you apply the input parameters above:

And here is the same data but in JSON. You can choose in which format to download your data: JSON, JSONL, Excel spreadsheet, HTML table, CSV, or XML.

1[
2	{
3		"post_id": "t3_1epeshq",
4		"subreddit": "ChatGPT",
5		"author_id": "t2_rpv4m",
6		"created_time": "2024-08-11T07:12:08.989Z",
7		"title": "These are all AI",
8		"type": "gallery",
9		"url": "https://www.reddit.com/r/ChatGPT/comments/1epeshq/these_are_all_ai/",
10		"score": 23116,
11		"comments": 3483,
12		"nsfw": false,
13		"spoiler": false,
14		"archived": false,
15		"media_type": "image",
16		"image": {
17			"src": "https://b.thumbs.redditmedia.com/wvxCY7MShbjFKif0kFCyClFLmBePLldkbjJtQ7RZOZY.jpg",
18			"alt": "These are all AI"
19		},
20		"votes": 23116,
21		"subreddit_icon": "https://styles.redditmedia.com/t5_7hqomg/styles/communityIcon_bzj6d1z1oizc1.png"
22	},
23	{
24		"post_id": "t3_1et27wq",
25		"subreddit": "aivideo",
26		"author_id": "t2_xq6eif4up",
27		"created_time": "2024-08-15T18:15:18.039Z",
28		"title": "Guys immitating AI videos accurately. The circle is complete",
29		"type": "video",
30		"url": "https://www.reddit.com/r/aivideo/comments/1et27wq/guys_immitating_ai_videos_accurately_the_circle/",
31		"score": 37528,
32		"comments": 574,
33		"nsfw": false,
34		"spoiler": false,
35		"archived": false,
36		"media_type": "image",
37		"image": {
38			"src": "https://external-preview.redd.it/bTNyZDB1ZjBkdmlkMVEnbl5Az5JTDsoBWZ_GgLpFsAe8uNFoI11saBoGoM5N.png?width=140&height=140&crop=140:140,smart&format=jpg&v=enabled&lthumb=true&s=377a54e68d8c64d87c354e63a0d740bfca6beab5",
39			"alt": "Guys immitating AI videos accurately. The circle is complete"
40		},
41		"votes": 37528,
42		"subreddit_icon": "https://styles.redditmedia.com/t5_fwb59/styles/communityIcon_zhuecbirl3pc1.png"
43	},
44    ...
45]