I keep losing my notes on grind size and ratio. What do you use?
", "postType": "text", "flair": "Question", "author": "example_user", "communityName": "example", "createdAt": "2026-10-15T07:14:20.292Z", "upVotes": 66, "upVoteRatio": 0.93, "numberOfComments": 16, "imageUrls": [], "videoUrls": [], "isAd": false, "source": "https://www.reddit.com/r/example/", "sourceType": "community", "scrapedAt": "2026-10-15T09:00:00.000Z" } ``` Comment rows add `postId`, `parentId`, `depth`, `numberOfReplies` and `html`; community rows add `description`, `weeklyVisitors`, `weeklyContributions`, `iconUrl` and `bannerUrl`; user rows add `karma`, `postKarma`, `commentKarma`, `iconUrl` and the account date in `createdAt`. Video posts list their Reddit video links in `videoUrls` (an HLS stream and, when Reddit offers one, an MP4 file). ### FAQ **How do I scrape Reddit comments without the Reddit API?** Paste the post URL into Reddit URLs (or a subreddit URL with Include comments on). The Actor returns each comment with author, score, depth, parent, date and text. You need no Reddit account or API key. **How do I export all posts from a subreddit to CSV or Excel?** Add the subreddit name, set Sort and Maximum posts per source, run, and download the dataset as CSV or Excel from the run page. **Can I find Reddit posts and comments that mention my brand or a keyword?** Yes. Put the words in Search terms and turn on Search for comments as well as posts. Use Sort = New with a schedule to keep an up-to-date list. **Can I get Reddit posts and comments between two dates?** Yes. Set Only posts since and Only posts until (Only comments since and Only comments until for comments). A plain date covers the whole day in UTC. **Can I use Reddit data for sentiment analysis or an AI dataset?** Yes. Each post and comment is one row with its text in plain form and HTML, score, date, author and subreddit, so you can download it as CSV or JSON and feed it to your analysis or RAG pipeline. **What happens if my run gets close to its time limit?** The Actor stops starting new pages about half a minute before the limit, keeps every row it already returned, adds a free row saying which inputs were not finished, and ends as Succeeded. **Do I need a Reddit account?** You need no account: the Actor returns what Reddit shows to anyone who is logged out. ### Pricing You pay per result row (post, comment, community or user), plus a small start fee for each run that depends on the run's memory (2 GB by default, at most 4 GB). Rows that only explain why something was not returned - a subreddit that does not exist, a page Reddit would not show, the run reaching its time or budget limit - are free and say so in the `note` column. Set a maximum charge for the run in Apify, and the Actor stops cleanly at that amount with a free row that tells you so. ### Limitations - Only content Reddit shows without logging in is returned. Private, banned, quarantined and members-only subreddits come back as a free row that gives Reddit's reason, and NSFW pages that ask you to log in are skipped. - r/all: Reddit sends visitors who are not logged in to its front page, which lists the same posts as r/popular, so that is what r/all returns. - With comments on, each post's first page of comments (about 20-25, in Reddit's order) is read quickly. Asking for more than 20 comments per post makes the Actor load more comments on each post, which takes longer. - Posts from search results include title, author, subreddit, score, comment count and date; their full text comes with Include comments on (the Actor then opens each post). - Deleted comments without text or author are skipped and not charged. Email addresses and phone numbers inside text are masked. - Subreddit info has weekly visitors and weekly contributions, which is what Reddit now shows instead of a member count. - User search returns the profile link, karma, description and avatar shown in Reddit's search; account date and post/comment karma come when you add the user to Users. - Media search results carry the title, author, subreddit and media links; score, date and text come with Include comments on (the Actor then opens each post). With a date filter, the Actor opens each post to read its date. - A post search with "Only posts since" and no Time range uses the shortest range that still covers your date (past day, week, month or year), so nothing in your range is left out. - When a date or flair filter makes the Actor open posts that turn out not to match, it stops after opening 30 such posts in one run and says so in a free row for each input it stopped. - `numberOfReplies` counts the direct replies when Reddit shows all of them on the post page; when Reddit folds some replies behind "more replies", it is null rather than a guess. - Video links expire after some time; download the videos soon after the run. - Promoted posts (ads) in subreddit feeds are skipped; every post row has `isAd`. - Author flair (the tag a user wears in a subreddit) is not returned: the pages Reddit shows without logging in do not include it. - This Actor is not affiliated with Reddit. Please use the data in line with Reddit's terms and the privacy of its users. ### Thanks for using this Actor We build these tools for people who run them every day, and we improve them from what users tell us. - **Missing a field, or need another filter?** Tell us in the **Issues** tab. If the data is there, we add it. - **Found a bug or a wrong value?** Post the run ID in the **Issues** tab. Wrong data is the thing we fix first. If this Actor saved you time, a short review helps other people find it. # Actor input Schema ## `startUrls` (type: `array`): Subreddit, post, user or search pages on reddit.com, for example https://www.reddit.com/r/technology/top/?t=week, https://www.reddit.com/r/AskReddit/comments/abc123/, https://www.reddit.com/user/spez/ or https://www.reddit.com/search/?q=coffee. Leave empty if you use the fields below. ## `subreddits` (type: `array`): Subreddit names without r/, in any letter case, for example technology, askreddit or popular. Each one returns its posts in the order set in Sort. Leave empty if not needed. ## `usernames` (type: `array`): Reddit user names without u/, in any letter case, for example spez. Each one returns the profile (karma, account date) and the user's posts and comments. Leave empty if not needed. ## `searches` (type: `array`): Words to search on Reddit, one per line, for example "best crm for startups". Choose below whether to search posts, comments, communities, users or media. Leave empty if not needed. ## `searchPosts` (type: `boolean`): Return posts that match the search terms. On by default. ## `searchComments` (type: `boolean`): Also return comments that match the search terms, with the post they belong to. Off by default. ## `searchCommunities` (type: `boolean`): Also return subreddits that match the search terms, with description and weekly visitors. Off by default. ## `searchUsers` (type: `boolean`): Also return Reddit users whose name or profile matches the search terms, with profile link, karma, description and avatar. Always searches all of Reddit. Off by default. ## `searchMedia` (type: `boolean`): Also return image and video posts that match the search terms, with their image and video links. Off by default. ## `searchCommunityName` (type: `string`): Limit the search terms to one subreddit, for example technology. Leave empty to search all of Reddit. ## `sort` (type: `string`): Order of posts. For subreddits: hot, new, top or rising. For searches: relevance, hot, top, new or comments. Leave empty for Reddit's default (hot for subreddits, relevance for search). A sort written in a start URL wins over this field. A sort that does not apply (rising for a search, relevance or comments for a subreddit) stops the run with a free row. ## `time` (type: `string`): For Top and for searches: hour, day, week, month, year or all. Leave empty for Reddit's default. With only subreddits that are not sorted by top, a time range stops the run with a free row (it would have no effect). ## `maxItems` (type: `integer`): Stop after this many result rows (posts, comments, communities and users together) across all sources. Default 100. ## `maxPostsPerSource` (type: `integer`): Most posts (or search results) to return from each URL, subreddit, user or search term. Default 25. ## `includeComments` (type: `boolean`): Open each post and return its full text and its top comments. Turn off for a faster, cheaper list of posts only (search results then come without the post text). On by default. ## `maxCommentsPerPost` (type: `integer`): Most comments to return for each post when comments are included, in the order Reddit shows them. Default 10. ## `includeCommunityInfo` (type: `boolean`): Return one row per subreddit with its title, description, weekly visitors and weekly contributions. On by default. ## `includeUserPosts` (type: `boolean`): For user pages, return the posts the user submitted. On by default. ## `includeUserComments` (type: `boolean`): For user pages, return the comments the user wrote. On by default. ## `postDateLimit` (type: `string`): Return only posts created on or after this date (YYYY-MM-DD). With Sort set to New, reading stops at the first page older than this date. Combine with "Only posts until" for a date range. Leave empty for no date limit. ## `commentDateLimit` (type: `string`): Return only comments created on or after this date (YYYY-MM-DD). Leave empty for no date limit. ## `postedBefore` (type: `string`): Return only posts created on or before this date (YYYY-MM-DD, the whole day in UTC) or time (for example 2026-01-31T12:00:00Z). Combine with "Only posts since" for a date range. Leave empty for no upper limit. ## `commentedBefore` (type: `string`): Return only comments created on or before this date (YYYY-MM-DD, the whole day in UTC) or time. Combine with "Only comments since" for a date range. Leave empty for no upper limit. ## `onlyWithFlair` (type: `boolean`): Return only posts that have a post flair (the tag such as Discussion or Question). For search results the Actor opens each post to read its flair. Off by default. ## `includeNSFW` (type: `boolean`): Keep posts and communities that Reddit marks as NSFW (18+) when Reddit shows them without logging in. Turn off to drop them. On by default. ## Actor input object example ```json { "startUrls": [ { "url": "https://www.reddit.com/r/technology/" } ], "searchPosts": true, "searchComments": false, "searchCommunities": false, "searchUsers": false, "searchMedia": false, "maxItems": 100, "maxPostsPerSource": 25, "includeComments": true, "maxCommentsPerPost": 10, "includeCommunityInfo": true, "includeUserPosts": true, "includeUserComments": true, "onlyWithFlair": false, "includeNSFW": true } ``` # Actor output Schema ## `results` (type: `string`): One row per Reddit post, comment, subreddit or user (dataType tells which): title, text, author, subreddit, score, upvote ratio, comment count, links, images and dates, plus subreddit info and user karma. Inputs that could not be read, and runs that stop before the time or budget limit, come back as a free row (dataType note) that says why. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '