Back to Reddit
Apify·Reddit
Reddit API
/practicaltools/apify-reddit-apiasync$0.0045 / resultThe most affordable Reddit scraper on the store. 60% cheaper than the competition. Perfect for training AI models, bulk historical data, and sentiment analysis. Runs as an Apify actor (20–120 s); results are dataset rows.
Charged per returned row plus the flat fee.
Input
| Field | Type | Required | Description |
|---|---|---|---|
| startUrls | array | — | Reddit URLs to scrape directly. Supports three URL types: • Subreddit (e.g. reddit.com/r/python/) — scrapes the subreddit feed • Post (e.g. reddit.com/r/python/comments/abc123/) — fetches that post and its comments • User (e.g. reddit.com/user/someuser/) — fetches the user profile and their recent p |
| searches | array | — | Keywords or phrases to search for on Reddit. Each query runs independently and returns up to Max Items results. Tip: wrap a query in quotes for exact phrase matching — e.g. '"web scraping"' will only match that exact phrase, while 'web scraping' matches posts containing both words anywhere. What g |
| sort | string (relevance, hot, new, top, comments, controversial, rising) | — | How to order results. For search queries: relevance (default) gives the best matches; new/top/hot/comments also work. For subreddit feeds: hot/new/top/controversial/rising. If you pick 'relevance' with a subreddit feed, it falls back to hot. relevance and comments are only valid for searches, not (default "relevance") |
| time | string (all, day, hour, month, week, year) | — | Limits results to posts created within the selected time window. Applies to both subreddit feeds and search queries. Use 'all' to include posts from any time. (default "all") |
| maxItems | integer | — | Maximum number of results per job. Each search query, subreddit, or URL counts as a separate job, so total output can exceed this number when you have multiple inputs. Example: 2 search queries × maxItems 25 = up to 50 posts total. (default 25) |
| includeNSFW | boolean | — | Include NSFW (Not Safe For Work) content. (default false) |
| skipComments | boolean | — | When scraping a direct post URL, comments are fetched by default. Enable this to get only the post metadata without its comments. Does not affect the 'Fetch Comments for Each Post' option. (default false) |
| skipUserPosts | boolean | — | When scraping a user profile, recent posts are fetched by default alongside profile info. Enable this to get only the profile metadata. (default false) |
| skipCommunity | boolean | — | When scraping a subreddit feed, community metadata (member count, description, etc.) is fetched alongside posts. Enable this to skip that extra request and get only posts. (default true) |
| ignorestartUrls | boolean | — | Forces search-only mode — Start URLs are ignored even if provided. Useful if you have URLs saved in your input but want to run a search-only job without deleting them. (default false) |
| searchPosts | boolean | — | Find posts matching the search keyword. Returns post objects with title, body, upvotes, and comment count. On by default — disable if you only want comments, communities, or users. (default true) |
| searchComments | boolean | — | Find comments matching the search keyword. Works by fetching posts that match the keyword and then filtering their comments — this uses more API calls than post search. (default false) |
| fetchPostComments | boolean | — | When enabled, each post returned from a subreddit or keyword search will include a 'comments' array with its top-level comments. Significantly increases API usage — one extra request per post. (default false) |
| searchCommunities | boolean | — | Find subreddits whose name or description matches the keyword. Returns community objects with member count, description, and URL. (default false) |
| searchUsers | boolean | — | Find Reddit user accounts matching the keyword. Returns user objects with karma, profile info, and account age. (default false) |
Run it
curl -s https://sooma.dev/v1/run \
-H "Authorization: Bearer $SOOMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"provider":"apify","endpoint":"/practicaltools/apify-reddit-api","input":{}}'
Or ask your agent: it will call inspect for this schema and run it over MCP.