Dataspryva
Actors/Reddit Subreddit Profile, Rules & Post Filter Scraper

Reddit Subreddit Profile, Rules & Post Filter Scraper

Scrape full community intelligence for any subreddit: description, subscriber count, active users, weekly activity, posting rules, wiki pages, icons/colors and settings - plus optional recent posts. No API key or login.

Open on ApifyGitHub source

Input schema

Input fields, types, required flags, descriptions, defaults, and prefills come from the published definition. Prefill examples are distinct from defaults.

FieldTypeRequiredDescription
modestringrequiredPick the result you want. 'Communities' returns one profile per subreddit (plus optional posts and comments). 'Discover' finds communities by keyword or browse. 'Posts' returns post records only. 'Comments' returns capped comment trees for post URLs or a subreddit's top posts.
subredditsarrayoptionalSubreddit names to scrape. Accepts bare names, r/ names or full URLs. Use the name as shown in the subreddit URL (Reddit redirects are challenged on some networks). Not needed when 'postUrls' is set or when discovery finds enough communities.
postUrlsarrayoptionalReddit post or comment URLs (or bare post IDs) to scrape in comments mode. When set, these take priority over subreddit top posts. Example: https://www.reddit.com/r/pics/comments/1x1xbpb/
Show all input fields
FieldTypeRequiredDescription
modestringrequiredPick the result you want. 'Communities' returns one profile per subreddit (plus optional posts and comments). 'Discover' finds communities by keyword or browse. 'Posts' returns post records only. 'Comments' returns capped comment trees for post URLs or a subreddit's top posts.
subredditsarrayoptionalSubreddit names to scrape. Accepts bare names, r/ names or full URLs. Use the name as shown in the subreddit URL (Reddit redirects are challenged on some networks). Not needed when 'postUrls' is set or when discovery finds enough communities.
postUrlsarrayoptionalReddit post or comment URLs (or bare post IDs) to scrape in comments mode. When set, these take priority over subreddit top posts. Example: https://www.reddit.com/r/pics/comments/1x1xbpb/
discoverModestringoptionalHow to find extra communities. 'Keyword search' uses the field below. 'Currently popular' and 'Newest' browse Reddit's curated lists (best-effort: those pages expose only a few communities).
discoverQuerystringoptionalSearch Reddit's community directory for this keyword and add the matching communities to the run. Only used with 'Keyword search'. Leave empty to skip discovery.
discoverSortstringoptionalHow to rank keyword-discovered communities: relevance keeps Reddit's order, activity sorts by weekly active users.
maxDiscoverResultsintegeroptionalMaximum number of communities to add from keyword search or browse (1-100).
includeRulesbooleanoptionalAdd posting rules (name, description, priority) to community profiles in communities mode.
includeWikibooleanoptionalFetch the community wiki index and each page's Markdown source. Wiki pages are omitted when the wiki is disabled or empty.
maxWikiPagesintegeroptionalMaximum number of wiki pages to fetch per community when 'Include wiki pages' is on (0-200).
includeWeeklyStatsbooleanoptionalInclude Reddit's weekly active users and weekly contributions from the community header.
includePostsbooleanoptionalAlso scrape the community's recent posts, with the full filter set below.
maxPostsintegeroptionalMaximum posts to collect per subreddit (1-1,000). The global 'Maximum records' cap still applies.
sortstringoptionalHow to order the post feed.
timeFilterstringoptionalTime window used when sorting posts by top or controversial.
includeNSFWbooleanoptionalKeep posts marked NSFW. NSFW-only communities are gated for signed-out visitors and return nothing regardless of this setting.
onlyWithFlairbooleanoptionalDrop posts that have no flair tag.
postTypestringoptionalKeep only one content type. Leave unset to keep all types.
minScoreintegeroptionalKeep posts with a score (upvotes minus downvotes) at or above this value. Leave unset to keep all scores.
maxScoreintegeroptionalKeep posts with a score at or below this value. Useful for finding overlooked posts. Leave unset to keep all scores.
minCommentsintegeroptionalKeep posts with at least this many comments. Leave unset to keep all posts.
maxCommentsintegeroptionalKeep posts with at most this many comments. Leave unset to keep all posts.
excludeStickiedbooleanoptionalDrop posts pinned by moderators (rules, weekly threads, announcements).
minUpvoteRationumberoptionalKeep posts whose upvote ratio (0-1) is at or above this value. Leave unset to keep all ratios.
excludeRemovedbooleanoptionalDrop posts removed by a moderator or Reddit. Deleted post markers are only visible on post detail pages.
excludeCrosspostsbooleanoptionalDrop crossposts from another community, keeping original submissions.
excludeSpoilersbooleanoptionalDrop posts marked as a spoiler by their author.
excludeLockedbooleanoptionalDrop posts whose comments were locked by a moderator.
excludeDeletedAuthorbooleanoptionalDrop posts whose author appears as [deleted] or [removed].
onlyOriginalContentbooleanoptionalKeep only posts the author tagged as original content.
minAwardsintegeroptionalKeep posts with at least this many total awards. Leave unset to keep all posts.
titleContainsstringoptionalKeep posts whose title contains this text (case-insensitive). Leave empty to keep all titles.
contentContainsstringoptionalKeep self posts whose body contains this text (case-insensitive). Requires 'Fetch full post details' so post bodies are available; link/image posts are excluded.
flairContainsstringoptionalKeep posts whose flair text contains this text (case-insensitive). Leave empty to keep all flairs.
authorFlairContainsstringoptionalKeep posts whose author flair text contains this text (case-insensitive).
authorsarrayoptionalKeep posts submitted by one of these usernames (bare or u/-prefixed, case-insensitive).
domainstringoptionalKeep posts whose link domain contains this text (case-insensitive), e.g. youtube.com or self.python.
distinguishedstringoptionalKeep posts distinguished by Reddit as moderator, admin or special, or keep only regular posts. Leave unset to keep all.
postedAfterstringoptionalKeep posts created on or after this date (UTC). When set, the post feed is walked from newest first.
postedBeforestringoptionalKeep posts created on or before this date (end of day, UTC).
includeCommentsbooleanoptionalFetch capped comment trees for every post collected in communities or posts mode. In comments mode this is always on.
maxCommentsPerPostintegeroptionalStop collecting a thread after this many comments (1-10,000). The global 'Maximum records' cap still applies.
commentSortstringoptionalHow Reddit orders the comment tree. 'Confidence' is Reddit's default best-first order; the other four are the verified alternate sorts.
maxCommentDepthintegeroptionalKeep comments up to this nesting depth. 0 keeps top-level comments only; each extra level adds replies (0-100).
includePostDetailsbooleanoptionalOpen each collected post page to fill body, media and detail-only flags. In comments mode this also saves the parent post record. Slower: one extra page per post.
maxItemsintegeroptionalHard cap on all records pushed by the run (communities, posts and comments together). The run stops cleanly when it is reached.

Download the published input schema

View complete JSON
{
  "description": "Choose a mode, then list subreddits or post URLs. Community profiles, rules, wiki pages, posts and capped comment trees all work without an API key or login.",
  "properties": {
    "authorFlairContains": {
      "description": "Keep posts whose author flair text contains this text (case-insensitive).",
      "editor": "textfield",
      "example": "Moderator",
      "title": "Author flair contains",
      "type": "string"
    },
    "authors": {
      "description": "Keep posts submitted by one of these usernames (bare or u/-prefixed, case-insensitive).",
      "editor": "stringList",
      "example": [
        "spez"
      ],
      "title": "Only these authors",
      "type": "array"
    },
    "commentSort": {
      "default": "confidence",
      "description": "How Reddit orders the comment tree. 'Confidence' is Reddit's default best-first order; the other four are the verified alternate sorts.",
      "editor": "select",
      "enum": [
        "confidence",
        "top",
        "new",
        "controversial",
        "old"
      ],
      "enumTitles": [
        "Confidence (best first)",
        "Top",
        "New",
        "Controversial",
        "Old"
      ],
      "prefill": "confidence",
      "title": "Sort comments by",
      "type": "string"
    },
    "contentContains": {
      "description": "Keep self posts whose body contains this text (case-insensitive). Requires 'Fetch full post details' so post bodies are available; link/image posts are excluded.",
      "editor": "textfield",
      "example": "tutorial",
      "title": "Post text contains",
      "type": "string"
    },
    "discoverMode": {
      "default": "search",
      "description": "How to find extra communities. 'Keyword search' uses the field below. 'Currently popular' and 'Newest' browse Reddit's curated lists (best-effort: those pages expose only a few communities).",
      "editor": "select",
      "enum": [
        "search",
        "popular",
        "new"
      ],
      "enumTitles": [
        "Keyword search",
        "Currently popular communities",
        "Newest communities"
      ],
      "prefill": "search",
      "title": "Discovery source",
      "type": "string"
    },
    "discoverQuery": {
      "description": "Search Reddit's community directory for this keyword and add the matching communities to the run. Only used with 'Keyword search'. Leave empty to skip discovery.",
      "editor": "textfield",
      "example": "machine learning",
      "title": "Discover communities by keyword",
      "type": "string"
    },
    "discoverSort": {
      "default": "relevance",
      "description": "How to rank keyword-discovered communities: relevance keeps Reddit's order, activity sorts by weekly active users.",
      "editor": "select",
      "enum": [
        "relevance",
        "activity"
      ],
      "enumTitles": [
        "Relevance",
        "Activity (most weekly visitors first)"
      ],
      "prefill": "relevance",
      "title": "Discovery ranking",
      "type": "string"
    },
    "distinguished": {
      "description": "Keep posts distinguished by Reddit as moderator, admin or special, or keep only regular posts. Leave unset to keep all.",
      "editor": "select",
      "enum": [
        "moderator",
        "admin",
        "special",
        "none"
      ],
      "enumTitles": [
        "Moderator posts only",
        "Admin posts only",
        "Special (official) posts only",
        "Regular posts only"
      ],
      "title": "Official posts only",
      "type": "string"
    },
    "domain": {
      "description": "Keep posts whose link domain contains this text (case-insensitive), e.g. youtube.com or self.python.",
      "editor": "textfield",
      "example": "youtube.com",
      "title": "Domain contains",
      "type": "string"
    },
    "excludeCrossposts": {
      "default": false,
      "description": "Drop crossposts from another community, keeping original submissions.",
      "prefill": false,
      "title": "Exclude crossposts",
      "type": "boolean"
    },
    "excludeDeletedAuthor": {
      "default": false,
      "description": "Drop posts whose author appears as [deleted] or [removed].",
      "prefill": false,
      "title": "Exclude deleted authors",
      "type": "boolean"
    },
    "excludeLocked": {
      "default": false,
      "description": "Drop posts whose comments were locked by a moderator.",
      "prefill": false,
      "title": "Exclude locked posts",
      "type": "boolean"
    },
    "excludeRemoved": {
      "default": false,
      "description": "Drop posts removed by a moderator or Reddit. Deleted post markers are only visible on post detail pages.",
      "prefill": false,
      "title": "Exclude removed/deleted posts",
      "type": "boolean"
    },
    "excludeSpoilers": {
      "default": false,
      "description": "Drop posts marked as a spoiler by their author.",
      "prefill": false,
      "title": "Exclude spoiler-tagged posts",
      "type": "boolean"
    },
    "excludeStickied": {
      "default": false,
      "description": "Drop posts pinned by moderators (rules, weekly threads, announcements).",
      "prefill": false,
      "title": "Exclude stickied posts",
      "type": "boolean"
    },
    "flairContains": {
      "description": "Keep posts whose flair text contains this text (case-insensitive). Leave empty to keep all flairs.",
      "editor": "textfield",
      "example": "Discussion",
      "title": "Flair contains",
      "type": "string"
    },
    "includeComments": {
      "default": false,
      "description": "Fetch capped comment trees for every post collected in communities or posts mode. In comments mode this is always on.",
      "prefill": false,
      "sectionCaption": "Comments",
      "title": "Include comments for collected posts",
      "type": "boolean"
    },
    "includeNSFW": {
      "default": false,
      "description": "Keep posts marked NSFW. NSFW-only communities are gated for signed-out visitors and return nothing regardless of this setting.",
      "prefill": false,
      "title": "Include NSFW (18+) posts",
      "type": "boolean"
    },
    "includePostDetails": {
      "default": false,
      "description": "Open each collected post page to fill body, media and detail-only flags. In comments mode this also saves the parent post record. Slower: one extra page per post.",
      "prefill": false,
      "title": "Fetch full post details",
      "type": "boolean"
    },
    "includePosts": {
      "default": true,
      "description": "Also scrape the community's recent posts, with the full filter set below.",
      "prefill": false,
      "sectionCaption": "Posts",
      "title": "Include recent posts",
      "type": "boolean"
    },
    "includeRules": {
      "default": true,
      "description": "Add posting rules (name, description, priority) to community profiles in communities mode.",
      "prefill": true,
      "sectionCaption": "Community profile",
      "title": "Include community rules",
      "type": "boolean"
    },
    "includeWeeklyStats": {
      "default": true,
      "description": "Include Reddit's weekly active users and weekly contributions from the community header.",
      "prefill": false,
      "title": "Include weekly activity",
      "type": "boolean"
    },
    "includeWiki": {
      "default": false,
      "description": "Fetch the community wiki index and each page's Markdown source. Wiki pages are omitted when the wiki is disabled or empty.",
      "prefill": false,
      "title": "Include wiki pages",
      "type": "boolean"
    },
    "maxCommentDepth": {
      "default": 3,
      "description": "Keep comments up to this nesting depth. 0 keeps top-level comments only; each extra level adds replies (0-100).",
      "maximum": 100,
      "minimum": 0,
      "prefill": 3,
      "title": "Maximum comment depth",
      "type": "integer"
    },
    "maxComments": {
      "description": "Keep posts with at most this many comments. Leave unset to keep all posts.",
      "example": 500,
      "maximum": 1000000,
      "minimum": 0,
      "title": "Maximum number of comments",
      "type": "integer"
    },
    "maxCommentsPerPost": {
      "default": 25,
      "description": "Stop collecting a thread after this many comments (1-10,000). The global 'Maximum records' cap still applies.",
      "maximum": 10000,
      "minimum": 1,
      "prefill": 25,
      "title": "Maximum comments per post",
      "type": "integer"
    },
    "maxDiscoverResults": {
      "default": 10,
      "description": "Maximum number of communities to add from keyword search or browse (1-100).",
      "maximum": 100,
      "minimum": 1,
      "prefill": 10,
      "title": "Maximum discovered communities",
      "type": "integer"
    },
    "maxItems": {
      "default": 1000,
      "description": "Hard cap on all records pushed by the run (communities, posts and comments together). The run stops cleanly when it is reached.",
      "maximum": 100000,
      "minimum": 1,
      "prefill": 1,
      "sectionCaption": "Output control",
      "title": "Maximum records",
      "type": "integer"
    },
    "maxPosts": {
      "default": 25,
      "description": "Maximum posts to collect per subreddit (1-1,000). The global 'Maximum records' cap still applies.",
      "maximum": 1000,
      "minimum": 1,
      "prefill": 25,
      "title": "Maximum posts per subreddit",
      "type": "integer"
    },
    "maxScore": {
      "description": "Keep posts with a score at or below this value. Useful for finding overlooked posts. Leave unset to keep all scores.",
      "example": 1000,
      "maximum": 1000000,
      "minimum": -1000000,
      "title": "Maximum score",
      "type": "integer"
    },
    "maxWikiPages": {
      "default": 20,
      "description": "Maximum number of wiki pages to fetch per community when 'Include wiki pages' is on (0-200).",
      "maximum": 200,
      "minimum": 0,
      "prefill": 20,
      "title": "Maximum wiki pages",
      "type": "integer"
    },
    "minAwards": {
      "description": "Keep posts with at least this many total awards. Leave unset to keep all posts.",
      "example": 1,
      "maximum": 1000000,
      "minimum": 0,
      "title": "Minimum awards",
      "type": "integer"
    },
    "minComments": {
      "description": "Keep posts with at least this many comments. Leave unset to keep all posts.",
      "example": 5,
      "maximum": 1000000,
      "minimum": 0,
      "title": "Minimum number of comments",
      "type": "integer"
    },
    "minScore": {
      "description": "Keep posts with a score (upvotes minus downvotes) at or above this value. Leave unset to keep all scores.",
      "example": 10,
      "maximum": 1000000,
      "minimum": -1000000,
      "title": "Minimum score",
      "type": "integer"
    },
    "minUpvoteRatio": {
      "description": "Keep posts whose upvote ratio (0-1) is at or above this value. Leave unset to keep all ratios.",
      "example": 0.8,
      "maximum": 1,
      "minimum": 0,
      "title": "Minimum upvote ratio",
      "type": "number"
    },
    "mode": {
      "default": "communities",
      "description": "Pick the result you want. 'Communities' returns one profile per subreddit (plus optional posts and comments). 'Discover' finds communities by keyword or browse. 'Posts' returns post records only. 'Comments' returns capped comment trees for post URLs or a subreddit's top posts.",
      "editor": "select",
      "enum": [
        "communities",
        "discover",
        "posts",
        "comments"
      ],
      "enumTitles": [
        "Community profiles (plus optional posts/comments)",
        "Discover communities by keyword or browse",
        "Posts from subreddits",
        "Comments from post URLs or top posts"
      ],
      "prefill": "communities",
      "sectionCaption": "Mode and sources",
      "title": "What to scrape",
      "type": "string"
    },
    "onlyOriginalContent": {
      "default": false,
      "description": "Keep only posts the author tagged as original content.",
      "prefill": false,
      "title": "Only original content (OC)",
      "type": "boolean"
    },
    "onlyWithFlair": {
      "default": false,
      "description": "Drop posts that have no flair tag.",
      "prefill": false,
      "title": "Only posts with a flair",
      "type": "boolean"
    },
    "postType": {
      "description": "Keep only one content type. Leave unset to keep all types.",
      "editor": "select",
      "enum": [
        "self",
        "link",
        "image",
        "video",
        "gallery",
        "poll"
      ],
      "enumTitles": [
        "Text (self post)",
        "Link",
        "Image",
        "Video",
        "Gallery",
        "Poll"
      ],
      "title": "Only this post type",
      "type": "string"
    },
    "postUrls": {
      "description": "Reddit post or comment URLs (or bare post IDs) to scrape in comments mode. When set, these take priority over subreddit top posts. Example: https://www.reddit.com/r/pics/comments/1x1xbpb/",
      "editor": "stringList",
      "example": [
        "https://www.reddit.com/r/pics/comments/1x1xbpb/expressing_multiple_emotions_at_one_time/"
      ],
      "title": "Post URLs (comments mode)",
      "type": "array"
    },
    "postedAfter": {
      "description": "Keep posts created on or after this date (UTC). When set, the post feed is walked from newest first.",
      "editor": "datepicker",
      "example": "2025-01-01",
      "title": "Created on or after",
      "type": "string"
    },
    "postedBefore": {
      "description": "Keep posts created on or before this date (end of day, UTC).",
      "editor": "datepicker",
      "example": "2025-12-31",
      "title": "Created on or before",
      "type": "string"
    },
    "sort": {
      "default": "hot",
      "description": "How to order the post feed.",
      "editor": "select",
      "enum": [
        "hot",
        "new",
        "top",
        "rising",
        "controversial",
        "best"
      ],
      "enumTitles": [
        "Hot",
        "New",
        "Top",
        "Rising",
        "Controversial",
        "Best"
      ],
      "prefill": "hot",
      "title": "Sort posts by",
      "type": "string"
    },
    "subreddits": {
      "description": "Subreddit names to scrape. Accepts bare names, r/ names or full URLs. Use the name as shown in the subreddit URL (Reddit redirects are challenged on some networks). Not needed when 'postUrls' is set or when discovery finds enough communities.",
      "editor": "stringList",
      "example": [
        "python",
        "r/programming",
        "https://www.reddit.com/r/webdev/"
      ],
      "prefill": [
        "Python"
      ],
      "title": "Subreddits",
      "type": "array"
    },
    "timeFilter": {
      "default": "day",
      "description": "Time window used when sorting posts by top or controversial.",
      "editor": "select",
      "enum": [
        "hour",
        "day",
        "week",
        "month",
        "year",
        "all"
      ],
      "enumTitles": [
        "Past hour",
        "Past day",
        "Past week",
        "Past month",
        "Past year",
        "All time"
      ],
      "prefill": "day",
      "title": "Time window for top/controversial",
      "type": "string"
    },
    "titleContains": {
      "description": "Keep posts whose title contains this text (case-insensitive). Leave empty to keep all titles.",
      "editor": "textfield",
      "example": "launch",
      "title": "Title contains",
      "type": "string"
    }
  },
  "required": [
    "mode"
  ],
  "schemaVersion": 1,
  "title": "Reddit Community Scraper Input",
  "type": "object"
}

Output schema

Published result links and storage locations. This schema is not an exhaustive contract for every field in a dataset record.

FieldTypeRequiredDescription
recordsstringoptionalDataset with one record per community, one per collected post and one per comment. Records are distinguished by `dataType`: `community`, `post` or `comment`. Empty fields are omitted.

Download the published output schema

View complete JSON
{
  "actorOutputSchemaVersion": 1,
  "description": "Community profiles (with rules, wiki and weekly activity), filtered posts and capped comment trees from Reddit's public pages. Records are distinguished by the `dataType` field.",
  "properties": {
    "records": {
      "description": "Dataset with one record per community, one per collected post and one per comment. Records are distinguished by `dataType`: `community`, `post` or `comment`. Empty fields are omitted.",
      "template": "{{links.apiDefaultDatasetUrl}}/items",
      "title": "Community, post & comment records",
      "type": "string"
    }
  },
  "title": "Reddit Community, Posts & Comments Scraper Output"
}

Dataset schema

Published dataset views and any declared field definitions. A view can select only a subset of the returned record fields.

Download the published dataset schema

View complete JSON
{
  "actorSpecification": 1,
  "views": {
    "overview": {
      "display": {
        "component": "table",
        "properties": {}
      },
      "title": "Community, post & comment records",
      "transformation": {
        "fields": [
          "dataType",
          "subreddit_prefixed",
          "title",
          "post_title",
          "author",
          "score",
          "num_comments",
          "weekly_active_users",
          "created_at",
          "url"
        ]
      }
    }
  }
}

Key-value schema

Published key-value store definitions, when provided by this build.

This definition is not present in the default published build. See the published README for available documentation.

Published README

Read the full published documentation

Reddit Community, Posts & Comments Scraper

Scrape Reddit communities without an account: profile details, weekly activity, posting rules, wiki pages, filtered post feeds and capped comment trees. Find communities by keyword, collect a subreddit's recent posts, or follow post URLs into their comment threads. No API key, login or proxy setup.

What this actor does

  • Four modes: communities (default), discover, posts and comments
  • Community intelligence: name, description, creation date, community type, weekly active users, weekly contributions, rules and wiki pages
  • Filtered feeds: sort, time window, date range, score/comment/award thresholds, post type, flair/title/body keywords, author allowlist, domain, and exclusion flags
  • Comment trees: 20-25 comments per page with "load more" expansion, four alternate sort orders, per-post and depth caps
  • Keyword discovery: search Reddit's community directory and optionally scrape posts from everything it finds (discovery records are search snapshots; use communities mode for full profiles)
  • Empty fields are omitted — records only contain values Reddit actually returned

Output: community records (dataType: "community")

One record per community in communities and discover modes.

  • subreddit, subreddit_prefixed, subreddit_id, url — identity
  • description, public_description, community_icon, icon_img — presentation
  • created_utc, created_at, subreddit_type, wiki_enabled — metadata
  • weekly_active_users, weekly_contributions — Reddit's weekly activity metrics
  • subscribers, active_user_count and the extended community settings — best-effort: included when Reddit's public metadata endpoint is reachable from the run's network, otherwise omitted
  • rules[] — short_name, description, description_html, priority
  • wiki_pages[] — name, content_md (Markdown source)
  • stickies[] — up to two pinned/highlighted posts using the post fields below (when posts are collected)
  • search_term — the discovery keyword that surfaced the community
  • crawled_at, source — fetch timestamp and data source

Output: post records (dataType: "post")

One record per collected post in communities, discover and posts modes.

  • post_id, post_name, subreddit, subreddit_prefixed, subreddit_id — identity
  • title, content, content_html, content_url, url, permalink, domain, post_type, media_type — content
  • author, author_id, link_flair, author_flair, author_flair_* — author and flair
  • score, ups, upvote_ratio, num_comments, total_awards_received, awards[] — engagement
  • images[], gallery_images[], gallery_count, video_url, thumbnail_url, has_media — media
  • is_stickied, is_locked, is_archived, is_pinned, is_nsfw, is_spoiler, is_original_content, is_crosspost, distinguished, removed_by_category — flags
  • poll_data, crosspost_parent_id, language, created_utc, created_at, edited, edited_at — extras
  • crawled_at, source — fetch timestamp and data source

Output: comment records (dataType: "comment")

One record per comment in comments mode, or when "Include comments for collected posts" is on.

  • comment_id, comment_name, post_id, post_title, post_url, link_id — identity
  • author, body, body_html, content_type — content
  • score, total_awards_received, depth, position, parent_positions, parent_id, parent_kind — engagement and tree position
  • is_op, is_stickied, is_locked, collapsed, is_highlighted — flags
  • subreddit, subreddit_prefixed, subreddit_id, permalink — context
  • created_utc, created_at, edited, edited_at — timing
  • crawled_at, source — fetch timestamp and data source

Input

Field Type Default Description
mode string communities communities, discover, posts or comments
subreddits array – Names, r/ names or full URLs (prefill: python)
postUrls array – Post/comment URLs or bare IDs for comments mode
discoverMode string search search, popular or new
discoverQuery string – Keyword for community discovery
discoverSort string relevance relevance or activity
maxDiscoverResults int 10 Discovered communities cap (1-100)
includeRules bool true Add community rules
includeWiki bool false Add wiki pages and Markdown
maxWikiPages int 20 Wiki pages per community (0-200)
includeWeeklyStats bool true Weekly active users and contributions
includePosts bool true Collect recent posts
maxPosts int 25 Posts per subreddit (1-1,000)
sort string hot hot, new, top, rising, controversial, best
timeFilter string day hour/day/week/month/year/all
includeNSFW bool false Keep NSFW posts
onlyWithFlair bool false Keep only posts with a flair
postType string – self/link/image/video/gallery/poll
minScore / maxScore int – Score range
minComments / maxComments int – Comment-count range
excludeStickied bool false Drop pinned posts
minUpvoteRatio number – Minimum upvote ratio (0-1)
excludeRemoved bool false Drop removed posts
excludeCrossposts bool false Drop crossposts
excludeSpoilers bool false Drop spoilers
excludeLocked bool false Drop locked posts
excludeDeletedAuthor bool false Drop deleted authors
onlyOriginalContent bool false Keep only OC posts
minAwards int – Minimum total awards
titleContains string – Title substring (case-insensitive)
contentContains string – Body substring (requires post details)
flairContains string – Flair substring
authorFlairContains string – Author-flair substring
authors array – Author allowlist
domain string – Link-domain substring
distinguished string – moderator/admin/special/none
postedAfter / postedBefore date – Creation-date window (UTC)
includeComments bool false Comments for collected posts
maxCommentsPerPost int 25 Comments per post (1-10,000)
commentSort string confidence confidence, top, new, controversial, old
maxCommentDepth int 3 Keep replies up to this depth (0 = top-level only)
includePostDetails bool false Open post pages for body/media/flags
maxItems int 1000 Hard cap across all record types

Example: community profile with rules and weekly activity

{
  "mode": "communities",
  "subreddits": ["python", "learnpython"],
  "includeRules": true,
  "includeWeeklyStats": true,
  "includePosts": false
}

Example: top posts from several communities

{
  "mode": "posts",
  "subreddits": ["technology", "programming"],
  "sort": "top",
  "timeFilter": "week",
  "maxPosts": 100,
  "minScore": 500,
  "minComments": 50,
  "postType": "self",
  "excludeStickied": true,
  "maxItems": 200
}

Example: discover communities by keyword

{
  "mode": "discover",
  "discoverMode": "search",
  "discoverQuery": "machine learning",
  "discoverSort": "activity",
  "maxDiscoverResults": 15,
  "includePosts": false
}

Example: comment trees from post URLs

{
  "mode": "comments",
  "postUrls": [
    "https://www.reddit.com/r/pics/comments/1x1xbpb/expressing_multiple_emotions_at_one_time/"
  ],
  "commentSort": "top",
  "maxCommentsPerPost": 100,
  "maxCommentDepth": 3,
  "includePostDetails": true,
  "maxItems": 150
}

Use cases

  • Community due diligence — profile a subreddit's rules, activity and culture before posting or advertising
  • Brand and topic monitoring — schedule weekly runs over niche communities and track post volume and engagement
  • Moderation research — compare posting rules and pinned guidance across many communities
  • Content strategy — find high-performing post types, flairs and domains in a target community
  • Audience research — follow a thread's comment tree to understand sentiment and objections
  • Community discovery — search by topic and get profiles for every relevant subreddit

FAQ

Do I need a Reddit account, API key or proxy? No. The actor reads Reddit's public pages and needs no credentials. It tries a direct connection first and only falls back to proxy routes if the network is blocked.

Why are subscriber counts sometimes missing? Reddit no longer shows member counts to signed-out visitors on the rendered page. The actor fills subscribers only when a public metadata endpoint happens to be reachable from the run's network; otherwise the field is omitted rather than guessed.

Why is the moderator list missing? The public moderator list is login-gated on Reddit. Signed-out runs cannot see it, so moderators is normally omitted.

Why is a subreddit missing from my run? Private, banned, NSFW-gated or nonexistent communities return nothing. The run log lists the skipped names. Public communities with no matching posts are also reported.

Why do discovery records have no rules or wiki? Discovery mode returns the community information Reddit shows in search results (name, description, icon, weekly activity). Run communities mode with the discovered names for full rules, wiki and creation details.

Why does contentContains return nothing? Post bodies are not on feed cards. Turn on "Fetch full post details" so the actor opens each post page before applying the body filter.

How many posts can I get? The feed is walked page by page (24-25 posts per page) until your maxPosts or global maxItems cap is reached. Reddit may stop serving older pages for very deep walks; split by date window with postedAfter/postedBefore if you need more history.

How do comment caps work? maxCommentsPerPost stops a thread after N comments, maxCommentDepth drops deeper replies, and maxItems caps the whole run. Setting depth to 0 keeps top-level comments only. postUrls can also point at a comment permalink.

Why does comments mode return nothing on Apify cloud? Reddit currently challenges individual post/comment pages on Apify's residential exits even though community feeds, search and about pages load normally. This is a confirmed cloud hard limit, not an input error or a transient retry issue: the actor stops after two challenged post pages and reports it in the status message. Community, post and discovery modes are unaffected. Comment trees are verified from non-cloud networks.

Can I export the data? Yes — JSON, CSV, Excel, XML or HTML, plus REST API and integrations with n8n, Zapier, Make and AI agents via the Apify MCP server.

Is this affiliated with Reddit? No. It is a third-party actor that reads publicly visible pages.

Python quickstart

Use a schema-derived input and the Python standard library to start a run. An Apify account and token are required for execution.

Open the step-by-step Python guide →

Source build Yy4ffYbftredacudh. Documentation is regenerated from the default published build; private drafts are not included.