Back to Reddit
Apify·Reddit

Reddit API

/practicaltools/apify-reddit-apiasync$0.0045 / result

The 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
FieldTypeRequiredDescription
startUrlsarrayReddit 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
searchesarrayKeywords 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
sortstring (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")
timestring (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")
maxItemsintegerMaximum 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)
includeNSFWbooleanInclude NSFW (Not Safe For Work) content. (default false)
skipCommentsbooleanWhen 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)
skipUserPostsbooleanWhen scraping a user profile, recent posts are fetched by default alongside profile info. Enable this to get only the profile metadata. (default false)
skipCommunitybooleanWhen 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)
ignorestartUrlsbooleanForces 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)
searchPostsbooleanFind 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)
searchCommentsbooleanFind 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)
fetchPostCommentsbooleanWhen 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)
searchCommunitiesbooleanFind subreddits whose name or description matches the keyword. Returns community objects with member count, description, and URL. (default false)
searchUsersbooleanFind Reddit user accounts matching the keyword. Returns user objects with karma, profile info, and account age. (default false)

Run it

curl -s https://www.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.