Reddit Subreddit Scraper

Extract posts from any public subreddit — title, author, score, flair, awards, post type, and optional top-level comment threads.

Features

• Scrape one or more subreddits in a single run
• Sort by hot, new, top (with a time range), or rising
• Automatically widens across sort modes to keep filling toward your requested count
• Optional per-post comment extraction (author, body, score, timestamp)
• Clean, typed output — numbers stay numbers, booleans stay booleans, arrays stay arrays

Usage

Basic

{
  "subreddits": ["technology"],
  "sort": "hot",
  "maxItems": 25
}

Multiple subreddits, top posts of the week

{
  "subreddits": ["technology", "science", "worldnews"],
  "sort": "top",
  "topTimeRange": "week",
  "maxItems": 50
}

With comments

{
  "subreddits": ["technology"],
  "sort": "hot",
  "maxItems": 10,
  "includeComments": true,
  "maxCommentsPerPost": 10
}

Comment extraction loads each post's own page, so it's slower than the default listing-only mode — expect roughly one extra page load per post.

Input Parameters

Parameter	Type	Default	Description
subreddits	Array	—	One or more subreddit names, without the r/ prefix. Required.
sort	String	hot	Listing sort: hot, new, top, or rising.
topTimeRange	String	day	Time window for top sort: hour, day, week, month, year, all.
maxItems	Integer	25	Maximum posts to return, across all subreddits combined. Required.
includeComments	Boolean	false	Fetch each post's top-level comments.
maxCommentsPerPost	Integer	10	Top-level comments to keep per post when includeComments is on.

Output

Each record is one post:

{
  "id": "t3_1wqnnai",
  "post_title": "Amazon's delivery drones are annoying an entire Texas neighborhood",
  "post_author": "AdSpecialist6598",
  "post_url": "https://www.reddit.com/r/technology/comments/1wqnnai/amazons_delivery_drones/",
  "post_content": "https://www.techspot.com/news/113979-amazon-delivery-drones.html",
  "post_type": "link",
  "subreddit": "technology",
  "score": 2498,
  "num_comments": 582,
  "created_utc": "2026-09-26T10:58:30.886000+0000",
  "flair": "Business",
  "is_nsfw": false,
  "is_pinned": false,
  "awards": [],
  "top_comments": [],
  "url": "https://www.reddit.com/r/technology/comments/1wqnnai/amazons_delivery_drones/",
  "scrapedAt": "2026-09-26T14:43:53.723Z"
}

post_content holds the outbound link for link/image/video posts, or the self-text for text posts (when includeComments is on — self-text isn't shown on the listing view). post_type is one of text, link, image, video, or poll.

With includeComments on, top_comments is populated:

"top_comments": [
  {
    "comment_author": "TwilitRose",
    "comment_body": "Amazon Prime now offers same-day tinnitus.",
    "comment_score": 677,
    "comment_created_utc": "2026-09-26T11:06:34.453000+0000"
  }
]

Notes

• A subreddit's hot/new/rising view surfaces a currently-active slice of its front page rather than a fixed page size — if your requested sort alone doesn't reach maxItems, the actor automatically pulls from the other sort modes for the same subreddit to keep filling. Ask for more subreddits, or a broader topTimeRange, for reliably larger runs.
• Reddit has not published a separate upvote/downvote breakdown since ~2016 — score is the net score shown on the page.
• Posts removed by moderators or deleted by their author may show null for post_author.