Reddit Subreddit Scraper

Give it a list of subreddits and get one clean row per community back: subscriber count, weekly visitors and contributions, creation date, type, NSFW and restriction flags, title and descriptions, icon, banner, rules and post flair templates. You can also pull new, hot, top, rising or controversial posts from each community. No Reddit account, cookies or API key needed.

Any subreddit in, clean community metadata out.

What it does

• Takes subreddit names in any common form, in bulk: startups, r/startups, https://www.reddit.com/r/startups/, https://old.reddit.com/r/startups/. Equivalent spellings are merged before anything is fetched or charged.
• Returns one row per community with:
  • ID, name, title, short and long description, canonical URL
  • subscribers, weekly visitors, weekly contributions
  • creation date, type, NSFW, quarantine and restriction flags
  • icon, banner, brand colour, language and Reddit's topic tags
• Adds the community's public rules (on by default) and its post flair templates (optional).
• Optionally collects posts as separate rows. You pick the sort (NEW, HOT, TOP, RISING, CONTROVERSIAL), a time range for TOP and CONTROVERSIAL, a per-subreddit limit and an "only posts newer than" filter.
• Private, banned, quarantined and nonexistent communities get a status row instead of failing the run, and those rows are free.
• Pushes rows as it goes, so a late failure never loses what was already captured.

Quick start

Minimal:

{
  "subreddits": ["r/startups", "dataengineering"]
}

Metadata with rules and flair templates:

{
  "subreddits": ["startups", "python"],
  "includeRules": true,
  "includePostFlairs": true
}

Recent posts:

{
  "subreddits": ["startups"],
  "includePosts": true,
  "postSort": "NEW",
  "maxPostsPerSubreddit": 100,
  "postsNewerThan": "7 days"
}

Top posts of the month:

{
  "subreddits": ["dataengineering"],
  "includePosts": true,
  "postSort": "TOP",
  "topTimeRange": "MONTH",
  "maxPostsPerSubreddit": 100
}

FAQ

Which subreddit input formats work? A bare name (startups), r/startups, /r/startups, or any reddit.com subreddit URL, including www., old. and new., and URLs with a trailing sort or /about/. Post, comment, user, search and multireddit URLs are rejected with a reason in the log, as are r/all and r/popular. A single run takes up to 1,000 communities.

Do I need a Reddit login or API key? No. You don't supply credentials, cookies or keys of any kind.

Which community fields are returned? See Subreddits below.

Are subscriber counts included? Yes, as subscribers.

Are active users included? Reddit no longer publishes an "online now" figure for most communities. When it does, activeUsers carries it; otherwise activeUsers is null. The activity signal Reddit shows today is weeklyVisitors and weeklyContributions, and both are always included. All activity numbers are point-in-time and can change a lot between runs.

Are rules included? Yes, by default: short name, full description, violation reason and Reddit's ordering. If the rules can't be read, you still get the community row, marked PARTIAL_RESULT.

Are post flairs included? Switch on includePostFlairs to get each community's public post flair templates (ID, text, moderator-only flag). Reddit doesn't publish flair colours on this route, so backgroundColor and textColor are null.

Can posts be scraped too? Yes. Switch on includePosts. Posts are separate rows with rowType: "post", so a community's metadata isn't repeated on every post.

Which post fields will I get? It depends on which source served the listing; the provider and dataQuality fields on each post tell you. Reddit currently blocks its own post listing for Apify's datacenter proxy, so with the default proxy most posts come from a backup source (provider: "tikhub", dataQuality: "PARTIAL"). Those rows have ID, title, author, score, comment count, flair, post type, created date, permalink, link, media, thumbnail, the stickied, locked and crosspost flags, and a crosspost's original post. The text is a short preview, and upvote ratio, author ID, language and the spoiler/NSFW/archived flags are null. Posts read from Reddit's own listing (

provider: "reddit-web"

Are crossposts handled? Yes. A crosspost row has postType: "CROSSPOST" and links to the original post, its ID and its community (or u_<username> when it was posted to a profile), from either source. See Posts.

Which sort modes work? NEW, HOT, TOP, RISING and CONTROVERSIAL. TOP and CONTROVERSIAL take a time range: past hour, day, week, month, year or all time. RISING is passed to Reddit as asked; on smaller communities Reddit may serve it in the same order as HOT.

How far back can posts go? Reddit's live listings expose a bounded history, commonly around the most recent or top ~1,000 posts per listing. A NEW listing with postsNewerThan stops as soon as it reaches older posts. Other sorts are read in Reddit's order and then filtered by date, which never means "every post in that period".

What do LIVE and ARCHIVE mean? Every row says source: "LIVE": it was read from Reddit during your run. This Actor has no archive fallback. If one is ever added, its rows will say ARCHIVE and will never be mixed in silently.

Are private communities supported? No. A private, gold-only, banned or quarantined community returns a free status row with whatever Reddit shows publicly (usually its ID, creation date and public description) and its status. Its posts are never fetched.

Are NSFW communities supported? Their metadata, yes. isNsfw is on the row. Posts from NSFW communities, and NSFW-tagged posts elsewhere, are collected only when you switch on includeNsfw.

How does pricing work? See Pricing.

Can runs be scheduled? Yes. Use Apify Schedules to track subscriber or activity changes over time. Each run is an independent snapshot.

Can I call it through the API or MCP? Yes. Use the Apify API, the JavaScript and Python clients, or Apify's MCP server, with the same JSON input as above.

Input reference

Output

All rows go to the run's default dataset. Each row has a rowType, either subreddit or post. The dataset has five views: Overview (both row types, in the columns they share: subreddit, title, URL, created date and so on), Subreddits, Rules & flairs, Posts and Status. In the Subreddits view post rows show as blank lines, and the other way round in the Posts view. Every field is present on every row of its type, and fields Reddit didn't provide are null.

The examples below are real records from a platform run on 2026-10-11 (input: startups, pics, interestingasfuck, lounge, fatpeoplehate and a made-up name, with posts on). Each one shows the columns of its view. Post authors are anonymised and long texts are shortened. Download the full dataset as JSON to get every field on every row.

Overview

Both row types together, in the columns they share.

A subreddit row:

{
  "rowType": "subreddit",
  "subreddit": "startups",
  "status": "SUCCESS",
  "title": "The community for ventures designed to scale rapidly | Read our rules before posting ❤️",
  "url": "https://www.reddit.com/r/startups/",
  "createdAt": "2008-01-25T05:23:46.341Z",
  "subscribers": 2138903,
  "weeklyVisitors": 84962,
  "score": null,
  "commentsCount": null,
  "author": null,
  "postType": null,
  "dataQuality": "FULL",
  "input": "startups"
}

A post row:

{
  "rowType": "post",
  "subreddit": "startups",
  "status": null,
  "title": "\"i will not promote\" how to get conversations with hvac ppl",
  "url": "https://www.reddit.com/r/startups/comments/1x3ep1o/",
  "createdAt": "2026-10-11T17:53:47.257Z",
  "subscribers": null,
  "weeklyVisitors": null,
  "score": 2,
  "commentsCount": 5,
  "author": "example_user",
  "postType": "TEXT",
  "dataQuality": "PARTIAL",
  "input": "startups"
}

Subreddits

One row per community.

{
  "rowType": "subreddit",
  "status": "SUCCESS",
  "name": "startups",
  "title": "The community for ventures designed to scale rapidly | Read our rules before posting ❤️",
  "subscribers": 2138903,
  "weeklyVisitors": 84962,
  "weeklyContributions": 1801,
  "activeUsers": null,
  "createdAt": "2008-01-25T05:23:46.341Z",
  "subredditType": "public",
  "isNsfw": false,
  "isQuarantined": false,
  "isRestricted": false,
  "publicDescription": "Welcome to /r/startups, the place to discuss startup problems and solutions. Startups are companies that are designed to grow and scale rapidly.  Be sure to read and follow all of our rules--we have specific places for common content and requests.",
  "rulesCount": 9,
  "topics": [
    "Startups & Entrepreneurship"
  ],
  "iconUrl": "https://b.thumbs.redditmedia.com/c7zj4Bem2INlJARtR9RfI_MsFlzzFlc57sejeYfSFNA.png",
  "bannerUrl": "https://styles.redditmedia.com/t5_2qh26/styles/bannerBackgroundImage_5inll9lan7511.jpg?frame=1&auto=webp&format=pjpg&s=a4088dedd81472060f4dfc7dfcf140a89951ff77",
  "url": "https://www.reddit.com/r/startups/",
  "subredditId": "t5_2qh26",
  "dataQuality": "FULL",
  "input": "startups",
  "scrapedAt": "2026-10-11T18:49:34.187Z"
}

Rules & flairs

The community's public rules and post flair templates. The first 2 of r/startups' 9 rules are shown. postFlairs is null here because includePostFlairs was off. When it's on, each template has id, text, isModOnly, backgroundColor and textColor (the last two are always null).

{
  "name": "startups",
  "status": "SUCCESS",
  "rulesCount": 9,
  "rules": [
    {
      "shortName": "Relevant Content Only",
      "description": "We are a community of discussion based around startups, not traditional businesses.\n\nAll content must be relevant to startups.\n\nYou are welcome to ask how to apply startup methodologies to your traditional business if you frame your question in a non-promotional way. We want you to be able to ask any question that helps your startup.",
      "violationReason": "not relevant",
      "priority": 0
    },
    {
      "shortName": "No direct sales, advertisements, or promotion",
      "description": "**No direct sales, advertisements, or promotional posts of any kind**. We have designated places that are an exception to this rule and they will always be stickied at the top of /r/startups.\n\n* You MAY share your startup in the Monthly Share Your Startup thread\n\nSelf-promotion is anything you have an interest, stake or relationship with including being friends with someone at the company.\n\nAt the end of the day, /r/startups moderators have the final say if your comments are promotional or not.",
      "violationReason": "No direct sales, advertisements, or self-promotion",
      "priority": 1
    }
  ],
  "postFlairs": null,
  "url": "https://www.reddit.com/r/startups/"
}

Posts

One row per post. This one came from the backup source (provider: "tikhub"), which is what Apify's datacenter proxy gets today (see the FAQ). So text is a preview, and upvoteRatio, isNsfw and isSpoiler are null. Posts read from Reddit's own listing (provider: "reddit-web") have the full text and every flag.

{
  "rowType": "post",
  "subreddit": "startups",
  "title": "\"i will not promote\" how to get conversations with hvac ppl",
  "author": "example_user",
  "score": 2,
  "upvoteRatio": null,
  "commentsCount": 5,
  "flair": "I will not promote",
  "postType": "TEXT",
  "createdAt": "2026-10-11T17:53:47.257Z",
  "permalink": "https://www.reddit.com/r/startups/comments/1x3ep1o/",
  "externalUrl": null,
  "crosspostParentUrl": null,
  "thumbnailUrl": null,
  "isStickied": false,
  "isNsfw": null,
  "isSpoiler": null,
  "isLocked": false,
  "text": "built an after-hours voice agent for hvac - linkedin free tier: 5 messages, 1 reply, from a retired owner - 60-80 ig + fb dms over 4 days: 0 replies - posted in…",
  "listingSort": "NEW",
  "listingRank": 1,
  "postId": "1x3ep1o",
  "provider": "tikhub",
  "scrapedAt": "2026-10-11T18:49:39.063Z"
}

postType is one of TEXT, LINK, IMAGE, GALLERY, VIDEO, POLL, CROSSPOST or UNKNOWN. media (in the full record) lists the post's own images or video stream, never avatars.

A crosspost (postType: "CROSSPOST", isCrosspost: true) names the post it was shared from in crosspostParentId, crosspostParentSubreddit and crosspostParentUrl (the Crossposted from column). When the original was posted to a user's profile rather than a community, crosspostParentSubreddit is Reddit's profile name for it, u_<username>, and the link goes to the /user/ page. All three are null on other posts. On backup-source rows a crosspost's media and thumbnailUrl are the original post's. This r/pics post was shared from r/drones (platform run, 2026-10-12; in the full record crosspostParentId is 1x3q70p, crosspostParentSubreddit is drones, and media holds the original's 1080 × 1920 image):

{
  "rowType": "post",
  "subreddit": "pics",
  "title": "Snake River • Jackson Hole",
  "author": "example_user",
  "score": 36,
  "upvoteRatio": null,
  "commentsCount": 2,
  "flair": null,
  "postType": "CROSSPOST",
  "createdAt": "2026-10-12T02:26:57.341Z",
  "permalink": "https://www.reddit.com/r/pics/comments/1x3q7i2/",
  "externalUrl": null,
  "crosspostParentUrl": "https://www.reddit.com/r/drones/comments/1x3q70p/",
  "thumbnailUrl": "https://cf.preview.redd.it/gzum6tk06yuh1.jpeg?width=1080&auto=webp&s=de63ac47e25a2807716387f847c06bd1de8e9cfe",
  "isStickied": false,
  "isNsfw": null,
  "isSpoiler": null,
  "isLocked": false,
  "text": null,
  "listingSort": "NEW",
  "listingRank": 2,
  "postId": "1x3q7i2",
  "provider": "tikhub",
  "scrapedAt": "2026-10-12T03:28:52.435Z"
}

Status

Every community's outcome. A private community's row is free:

{
  "name": "lounge",
  "status": "PRIVATE_SUBREDDIT",
  "unavailableReason": "GOLD_ONLY",
  "unavailableMessage": null,
  "statusNote": null,
  "dataQuality": "STATUS_ONLY",
  "provider": "tikhub",
  "postsExcludedReason": null,
  "input": "lounge",
  "sourceInputs": [
    "lounge"
  ],
  "capturedSequence": 2
}

Status values

postsExcludedReason: "NSFW_EXCLUDED" marks an NSFW community whose posts were skipped because includeNsfw was off.

Run reports (key-value store)

• RUN_SUMMARY: totals (inputs, unique communities, successes, failures by status, duplicates, posts saved and filtered), charges per event, and request counts.
• SUBREDDIT_SUMMARY: one record per community, with its status, which parts were read, how many posts were collected and why the post listing stopped.
• RETRY_INPUT: communities that hit blocking or transient errors, as a ready-to-run input. Private, banned and nonexistent communities are never included.

Pricing

Pay-per-event, with no start fee:

• Subreddit result: charged once per unique community whose full metadata is delivered. Equivalent inputs for the same community count once.
• Post result: charged once per unique post delivered, only when post collection is on.

Never charged: invalid inputs, duplicates, private, banned, quarantined or nonexistent communities, rows with basic metadata only, posts older than your date filter, NSFW posts skipped by your NSFW setting, retries, and the run summaries.

Live rates are on the Actor's Pricing tab, and they can differ by Apify plan; the tab shows the rate for yours. This README deliberately doesn't quote figures. Runs respect your per-run spending limit: when it's reached, the run stops fetching and finishes with everything paid for so far.

🚦 Proxy policy

Use Apify Datacenter proxy (the default) or no proxy. Subreddit metadata, rules and flairs don't depend on the proxy. For posts, Reddit currently blocks its own listing for Apify's datacenter addresses. The Actor retries on fresh IPs, then reads posts from a backup source with fewer fields (see the FAQ). Your own proxy under Custom proxy URLs can reach Reddit's listing directly.

Apify Residential proxy is not supported. The Actor fails at startup if apifyProxyGroups includes RESIDENTIAL. On pay-per-event Actors, residential bandwidth is billed per GB to the developer, not to your run. Post listing pages are large, so one bandwidth-heavy run could cost more than it earns.

If you really need residential routing, put your own provider in the proxy editor's Custom proxy URLs field. That traffic goes through your provider, not Apify, and is unaffected:

http://user:pass@proxy.iproyal.com:12321
http://user:pass@proxy.brightdata.com:22225
http://user:pass@proxy.oxylabs.io:7777

Limitations

• Public communities only. No private, moderator-only or logged-in data.
• Each unavailable community still costs a lookup. If a run has met 100 private, banned, quarantined or nonexistent communities and they outnumber the available ones, the rest of that run is checked with basic data only: status, icon, description and weekly stats, with no subscriber count or rules, and not charged. This applies to every user. A list that is mostly real communities never meets it.
• activeUsers is usually null; see the FAQ.
• Post flair colours are not available.
• Post listings are bounded by Reddit (commonly ~1,000 per listing), and RISING may come back in the same order as HOT on smaller communities.
• Reddit currently blocks its post listing for Apify's datacenter proxy, so with default settings posts usually come from a backup source. NEW, HOT and RISING carry on through it. Those rows have provider: "tikhub" and dataQuality: "PARTIAL": the text is a truncated preview (textIsPreview: true), and upvote ratio, author ID, language and the spoiler/NSFW/archived flags are null. Stickied, locked and crosspost flags, and a crosspost's original post, are filled. With includeNsfw off, NSFW communities are still excluded (their flag comes from the subreddit row), but NSFW-tagged posts inside other communities can't be recognised on these rows. TOP and CONTROVERSIAL listings have no backup with a time window. If they're blocked, the community is listed in RETRY_INPUT.
• A crosspost read from Reddit's own listing names its original post but has an empty media list.
• Subscriber counts, activity, scores and comment counts change constantly, and posts can be edited or deleted after a run.

Other Coregent Reddit Actors

• Reddit Comments Scraper: every comment of a thread as flat rows with parent, depth and path.

Responsible use

This is an unofficial tool, not affiliated with or endorsed by Reddit. It reads only public community data. Don't use it to deanonymise users or to infer sensitive attributes about them. You are responsible for processing the data lawfully, including under GDPR and Reddit's terms where they apply.

Changelog

• 1.0: first release. Community metadata, rules, post flair templates, optional posts with five sorts, time ranges and date filtering, crossposts linked to their original post, status rows for unavailable communities, and spending-limit compliance.