⭐️ FREE Reddit Scraper Pro
Pricing
Pay per usage
Free Reddit scraper that does what the paid ones do but better. No API keys needed, no usage fees. Pairs with ready-made n8n workflow templates for lead gen and content research.
Pricing
Pay per usage
Rating
5.0
(8)
Developer
Greg
Actor stats
13
Bookmarked
352
Total users
108
Monthly active users
a month ago
Last modified
Categories
Share
You can access the ⭐️ FREE Reddit Scraper Pro programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in Integrations settings in Apify Console.
{ "openapi": "3.0.1", "info": { "version": "0.0", "x-build-id": "jCfI09M1oxvwqEbOa" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/spry_wholemeal~reddit-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-spry_wholemeal-reddit-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/spry_wholemeal~reddit-scraper/runs": { "post": { "operationId": "runs-sync-spry_wholemeal-reddit-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/spry_wholemeal~reddit-scraper/run-sync": { "post": { "operationId": "run-sync-spry_wholemeal-reddit-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "scrape", "discover", "search", "domain" ], "type": "string", "description": "Choose what you want to do in this run.", "default": "scrape" }, "scrape": { "title": "Scrape settings", "type": "object", "description": "Used when <code>mode=\"scrape\"</code>.", "properties": { "subreddits": { "title": "Subreddits", "type": "array", "description": "Subreddits to scrape (without <code>r/</code>). Example: <code>startups</code>. One per line.", "editor": "stringList", "placeholderValue": "startups", "patternValue": "^(?:r\\/)?[A-Za-z0-9_]{2,21}$", "prefill": [ "entrepreneur", "startups" ], "minItems": 1, "uniqueItems": true }, "sort": { "title": "Sort", "type": "string", "description": "How to sort posts in each subreddit listing.", "editor": "select", "enum": [ "hot", "new", "top", "rising", "controversial" ], "enumTitles": [ "Hot (default)", "New", "Top", "Rising", "Controversial" ], "prefill": "hot" }, "timeframe": { "title": "Timeframe (for Top/Controversial)", "type": "string", "description": "Only used when sort is <code>top</code> or <code>controversial</code>.", "editor": "select", "enum": [ "hour", "day", "week", "month", "year", "all" ], "enumTitles": [ "Hour", "Day", "Week (default)", "Month", "Year", "All time" ], "prefill": "week" }, "maxPostsPerSubreddit": { "title": "Max posts per subreddit", "type": "integer", "description": "Safety limit to control runtime and cost. Reddit listings effectively cap around ~1000 items.", "editor": "number", "minimum": 1, "maximum": 1000, "prefill": 25 }, "commentsMode": { "title": "Comments mode", "type": "string", "description": "Choose when to fetch comments.", "editor": "select", "enum": [ "none", "all", "high_engagement" ], "enumTitles": [ "None (fastest)", "All posts", "High engagement only" ], "prefill": "none" }, "commentsMaxTopLevel": { "title": "Max top-level comments", "type": "integer", "description": "Top-level comments to request from Reddit. Use 0 for max (500).", "editor": "number", "minimum": 0, "maximum": 500, "prefill": 50 }, "commentsMaxDepth": { "title": "Max reply depth", "type": "integer", "description": "Semantic depth: 0 = top-level only, 1 = include direct replies, 2 = include replies-of-replies, etc.", "editor": "number", "minimum": 0, "maximum": 10, "prefill": 3 }, "commentsHighEngagementMinScore": { "title": "High engagement: min score", "type": "integer", "description": "Only used when comments mode is <code>high_engagement</code>.", "editor": "number", "minimum": 0, "maximum": 1000000, "prefill": 10 }, "commentsHighEngagementMinComments": { "title": "High engagement: min comment count", "type": "integer", "description": "Only used when comments mode is <code>high_engagement</code>.", "editor": "number", "minimum": 0, "maximum": 1000000, "prefill": 5 }, "commentsHighEngagementFilterPosts": { "title": "High engagement: omit non-qualifying posts", "type": "boolean", "description": "If enabled, posts that don’t meet the high-engagement threshold are not emitted to the dataset (more focused output).", "editor": "checkbox", "prefill": false }, "overrides": { "title": "Overrides (advanced)", "type": "array", "description": "Optional per-subreddit overrides (sort/timeframe/maxPosts/comments). Use only if you need different settings for specific subreddits.", "editor": "json", "prefill": [] }, "comments": { "title": "Comments (advanced JSON, optional)", "type": "object", "description": "Advanced/legacy shape: <code>{mode,maxTopLevel,maxDepth,highEngagement:{...}}</code>. If provided, it takes precedence over the fields above.", "editor": "hidden", "nullable": true } }, "additionalProperties": false }, "discover": { "title": "Discover settings", "type": "object", "description": "Used when <code>mode=\"discover\"</code>.", "properties": { "terms": { "title": "Search terms", "type": "array", "description": "Keywords to search for (one per line). Example: <code>saas</code>, <code>startup tools</code>.", "editor": "stringList", "placeholderValue": "saas", "prefill": [ "saas", "startup tools" ], "minItems": 1, "uniqueItems": true }, "maxSubredditsPerTerm": { "title": "Max subreddits per term", "type": "integer", "description": "How many candidate subreddits to return per term (before cross-term dedupe).", "editor": "number", "minimum": 1, "maximum": 100, "prefill": 25 }, "minSubscribers": { "title": "Min subscribers", "type": "integer", "description": "Filter out tiny subreddits.", "editor": "number", "minimum": 0, "maximum": 100000000, "prefill": 100 }, "includeNsfw": { "title": "Include NSFW subreddits", "type": "boolean", "description": "If disabled, NSFW subreddits are filtered out.", "editor": "checkbox", "prefill": false }, "estimateActivity": { "title": "Estimate activity (posts/day)", "type": "boolean", "description": "If enabled, fetches recent posts to estimate posting frequency (extra requests).", "editor": "checkbox", "prefill": true } }, "additionalProperties": false }, "search": { "title": "Search settings", "type": "object", "description": "Used when <code>mode=\"search\"</code>.", "properties": { "queries": { "title": "Queries", "type": "array", "description": "Search queries to run (one per line). Supports Reddit search syntax.", "editor": "stringList", "placeholderValue": "best CRM software", "prefill": [ "best CRM software", "project management tools" ], "minItems": 1 }, "sort": { "title": "Sort", "type": "string", "description": "How to sort search results.", "editor": "select", "enum": [ "relevance", "hot", "new", "top", "comments" ], "enumTitles": [ "Relevance (default)", "Hot", "New", "Top", "Most comments" ], "prefill": "relevance" }, "timeframe": { "title": "Timeframe", "type": "string", "description": "Time window. Automatically applied only for <code>sort=top</code> unless you set it explicitly in advanced targets.", "editor": "select", "enum": [ "hour", "day", "week", "month", "year", "all" ], "enumTitles": [ "Hour", "Day", "Week (default)", "Month", "Year", "All time" ], "prefill": "week" }, "maxPostsPerQuery": { "title": "Max posts per query", "type": "integer", "description": "Safety limit to control runtime and cost (per query).", "editor": "number", "minimum": 1, "maximum": 1000, "prefill": 25 }, "restrictToSubreddit": { "title": "Restrict to subreddit (optional)", "type": "string", "description": "Limit search to one subreddit (without <code>r/</code>).", "editor": "textfield", "prefill": "" }, "includeNsfw": { "title": "Include NSFW results", "type": "boolean", "description": "If disabled, NSFW results are filtered out.", "editor": "checkbox", "prefill": false }, "authorFilter": { "title": "Filter: author (optional)", "type": "string", "description": "Only posts by this username (adds <code>author:username</code> to every query).", "editor": "textfield", "prefill": "" }, "flairFilter": { "title": "Filter: flair (optional)", "type": "string", "description": "Only posts with this flair (adds <code>flair:text</code> to every query).", "editor": "textfield", "prefill": "" }, "selfPostsOnly": { "title": "Filter: self posts only", "type": "boolean", "description": "Only text posts (adds <code>self:yes</code> to every query).", "editor": "checkbox", "prefill": false }, "strictEnabled": { "title": "Strict matching (exact terms)", "type": "boolean", "description": "If enabled, we AND/OR a quoted term clause into every query (uses Reddit boolean search).", "editor": "checkbox", "prefill": false }, "strictOperator": { "title": "Strict operator", "type": "string", "description": "How to combine strict terms when strict matching is enabled.", "editor": "select", "enum": [ "AND", "OR" ], "default": "AND", "enumTitles": [ "AND (all terms)", "OR (any term)" ] }, "strictTerms": { "title": "Strict terms", "type": "array", "description": "Exact terms/phrases (one per line). Only used when strict matching is enabled.", "editor": "stringList", "placeholderValue": "voice agent", "prefill": [], "minItems": 0 }, "commentsMode": { "title": "Comments mode", "type": "string", "description": "Choose when to fetch comments for matched posts.", "editor": "select", "enum": [ "none", "all", "high_engagement" ], "enumTitles": [ "None (fastest)", "All posts", "High engagement only" ], "prefill": "none" }, "commentsMaxTopLevel": { "title": "Max top-level comments", "type": "integer", "description": "Top-level comments to request from Reddit. Use 0 for max (500).", "editor": "number", "minimum": 0, "maximum": 500, "prefill": 50 }, "commentsMaxDepth": { "title": "Max reply depth", "type": "integer", "description": "Semantic depth: 0 = top-level only, 1 = include direct replies, etc.", "editor": "number", "minimum": 0, "maximum": 10, "prefill": 3 }, "commentsHighEngagementMinScore": { "title": "High engagement: min score", "type": "integer", "description": "Only used when comments mode is <code>high_engagement</code>.", "editor": "number", "minimum": 0, "maximum": 1000000, "prefill": 10 }, "commentsHighEngagementMinComments": { "title": "High engagement: min comment count", "type": "integer", "description": "Only used when comments mode is <code>high_engagement</code>.", "editor": "number", "minimum": 0, "maximum": 1000000, "prefill": 5 }, "commentsHighEngagementFilterPosts": { "title": "High engagement: omit non-qualifying posts", "type": "boolean", "description": "If enabled, posts that don’t meet the high-engagement threshold are not emitted to the dataset (more focused output).", "editor": "checkbox", "prefill": false }, "overrides": { "title": "Overrides (advanced)", "type": "array", "description": "Optional per-query overrides (sort/timeframe/maxPosts/comments/restriction).", "editor": "json", "prefill": [] }, "targets": { "title": "Targets (advanced)", "type": "array", "description": "Advanced alternative to <code>queries</code> + <code>overrides</code>. Use to run duplicate queries with different settings.", "editor": "json", "prefill": [] }, "filters": { "title": "Filters (advanced JSON, optional)", "type": "object", "description": "Advanced/legacy shape: <code>{author,flair,selfPostsOnly}</code>. If provided, it takes precedence over the fields above.", "editor": "hidden", "nullable": true }, "strict": { "title": "Strict (advanced JSON, optional)", "type": "object", "description": "Advanced/legacy shape: <code>{enabled,operator,terms}</code>. If provided, it takes precedence over the fields above.", "editor": "hidden", "nullable": true }, "comments": { "title": "Comments (advanced JSON, optional)", "type": "object", "description": "Advanced/legacy shape: <code>{mode,maxTopLevel,maxDepth,highEngagement:{...}}</code>. If provided, it takes precedence over the fields above.", "editor": "hidden", "nullable": true } }, "additionalProperties": false }, "domain": { "title": "Domain settings", "type": "object", "description": "Used when <code>mode=\"domain\"</code>.", "properties": { "domains": { "title": "Domains", "type": "array", "description": "Domains to track (one per line). You can enter <code>example.com</code> or a full URL like <code>https://example.com/blog</code> (we’ll normalize it to the domain).<br/><br/><b>What you’ll get:</b> only posts that <i>link out</i> to that domain (not text-only mentions).", "editor": "stringList", "placeholderValue": "github.com", "prefill": [ "github.com", "news.ycombinator.com" ], "minItems": 1, "uniqueItems": true }, "sort": { "title": "Sort", "type": "string", "description": "How to sort domain posts.", "editor": "select", "enum": [ "hot", "new", "top", "rising", "controversial" ], "enumTitles": [ "Hot", "New (default)", "Top", "Rising", "Controversial" ], "prefill": "new" }, "timeframe": { "title": "Timeframe (for Top/Controversial)", "type": "string", "description": "Only used when sort is <code>top</code> or <code>controversial</code>.", "editor": "select", "enum": [ "hour", "day", "week", "month", "year", "all" ], "enumTitles": [ "Hour", "Day", "Week", "Month", "Year", "All time" ], "prefill": "week" }, "maxPostsPerDomain": { "title": "Max posts per domain", "type": "integer", "description": "Safety limit to control runtime and cost (per domain).", "editor": "number", "minimum": 1, "maximum": 1000, "prefill": 200 }, "commentsMode": { "title": "Comments mode", "type": "string", "description": "Choose when to fetch comments for matched posts.", "editor": "select", "enum": [ "none", "all", "high_engagement" ], "enumTitles": [ "None (fastest)", "All posts", "High engagement only" ], "prefill": "none" }, "commentsMaxTopLevel": { "title": "Max top-level comments", "type": "integer", "description": "Top-level comments to request from Reddit. Use 0 for max (500).", "editor": "number", "minimum": 0, "maximum": 500, "prefill": 50 }, "commentsMaxDepth": { "title": "Max reply depth", "type": "integer", "description": "Semantic depth: 0 = top-level only, 1 = include direct replies, etc.", "editor": "number", "minimum": 0, "maximum": 10, "prefill": 3 }, "commentsHighEngagementMinScore": { "title": "High engagement: min score", "type": "integer", "description": "Only used when comments mode is <code>high_engagement</code>.", "editor": "number", "minimum": 0, "maximum": 1000000, "prefill": 10 }, "commentsHighEngagementMinComments": { "title": "High engagement: min comment count", "type": "integer", "description": "Only used when comments mode is <code>high_engagement</code>.", "editor": "number", "minimum": 0, "maximum": 1000000, "prefill": 5 }, "commentsHighEngagementFilterPosts": { "title": "High engagement: omit non-qualifying posts", "type": "boolean", "description": "If enabled, posts that don’t meet the high-engagement threshold are not emitted to the dataset (more focused output).", "editor": "checkbox", "prefill": false }, "overrides": { "title": "Overrides (advanced)", "type": "array", "description": "Optional per-domain overrides (sort/timeframe/maxPosts/comments).", "editor": "json", "prefill": [] }, "targets": { "title": "Targets (advanced)", "type": "array", "description": "Advanced alternative to <code>domains</code> + <code>overrides</code>.", "editor": "json", "prefill": [] }, "comments": { "title": "Comments (advanced JSON, optional)", "type": "object", "description": "Advanced/legacy shape: <code>{mode,maxTopLevel,maxDepth,highEngagement:{...}}</code>. If provided, it takes precedence over the fields above.", "editor": "hidden", "nullable": true } }, "additionalProperties": false }, "tag": { "title": "Run tag (optional)", "type": "string", "description": "Optional label added to every output record. Useful for downstream filtering." }, "includeRaw": { "title": "Include raw Reddit JSON", "type": "boolean", "description": "Include the original Reddit payload under <code>raw</code> for each record (bigger output, mainly for debugging).", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Default is ON: Apify Proxy (RESIDENTIAL) + US. Disable only if you know what you’re doing.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }, "proxyCountry": { "title": "Proxy country", "pattern": "^[A-Z]{2}$", "type": "string", "description": "Two-letter country code (e.g. <code>US</code>, <code>GB</code>).", "default": "US" }, "proxyRotationStrategy": { "title": "Proxy rotation strategy", "enum": [ "sticky_pool", "per_request" ], "type": "string", "description": "How to rotate proxy IPs between requests.", "default": "sticky_pool" }, "proxyPoolSize": { "title": "Proxy pool size", "minimum": 1, "maximum": 50, "type": "integer", "description": "Number of sticky proxy sessions to maintain (only for sticky pool).", "default": 10 }, "requestDelayMs": { "title": "Request delay (ms)", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Delay between requests. Increase if you hit 429s (e.g. 200–500).", "default": 100 }, "customUserAgent": { "title": "Custom User-Agent (optional)", "type": "string", "description": "Overrides the default User-Agent header. Usually not needed." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } }}OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.
OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.
By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.
You can download the OpenAPI definitions for ⭐️ FREE Reddit Scraper Pro from the options below:
If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.
You can also check out our other API clients: