Reddit Scraper
DeprecatedPricing
$45.00/month + usage
Unlimited Reddit web scraper to crawl posts, comments, communities, and users without login. Limit web scraping by number of posts or items and extract all data in a dataset in multiple formats.
You can access the Reddit Scraper 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 API & Integrations in Apify Console.
{ "openapi": "3.0.1", "info": { "version": "5.7", "x-build-id": "FOsXitelBbflhkm1i" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/trudax~reddit-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-trudax-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/trudax~reddit-scraper/runs": { "post": { "operationId": "runs-sync-trudax-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/trudax~reddit-scraper/run-sync": { "post": { "operationId": "run-sync-trudax-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": [ "proxy" ], "properties": { "startUrls": { "title": "Start URLs", "type": "array", "description": "If you already have URL(s) of page(s) you wish to scrape, you can set them here. If you want to use the search field below, remove all startUrls here.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "skipComments": { "title": "Skip comments", "type": "boolean", "description": "This will skip scrapping comments when going through posts", "default": false }, "skipUserPosts": { "title": "Skip user posts", "type": "boolean", "description": "This will skip scrapping user posts when going through user activity", "default": false }, "skipCommunity": { "title": "Skip community", "type": "boolean", "description": "This will skip scrapping community info but will still get community posts if they were not skipped.", "default": false }, "includeMediaLinks": { "title": "Include media links, up votes and comment count", "type": "boolean", "description": "This will include upVotes, upVoteRatio, imageUrls, videoUrls, and numberOfComments when scraping posts. Enabling this will use a more detailed extraction method, which may affect performance.", "default": false }, "searches": { "title": "Search Term", "type": "array", "description": "Here you can provide a search query which will be used to search Reddit`s topics.", "items": { "type": "string" } }, "searchCommunityName": { "title": "Community (optional)", "type": "string", "description": "If provided, the search will be performed only inside this community (e.g., 'programming')." }, "ignoreStartUrls": { "title": "Ignore start URLs", "type": "boolean", "description": "Mainly used as a fix for ignoring starUrl on Zapier", "default": false }, "searchPosts": { "title": "Search for posts", "type": "boolean", "description": "Will search for posts with the provided search", "default": true }, "searchComments": { "title": "Search for comments", "type": "boolean", "description": "Will search for comments with the provided search", "default": false }, "searchCommunities": { "title": "Search for communities", "type": "boolean", "description": "Will search for communities with the provided search", "default": false }, "searchUsers": { "title": "Search for users", "type": "boolean", "description": "Will search for users with the provided search", "default": false }, "searchMedia": { "title": "Search for media", "type": "boolean", "description": "Will search for media with the provided search", "default": false }, "sort": { "title": "Sort search", "enum": [ "", "relevance", "hot", "top", "new", "rising", "comments" ], "type": "string", "description": "Sort search by Relevance, Hot, Top, New or Comments", "default": "new" }, "time": { "title": "Filter by date (Posts only)", "enum": [ "all", "hour", "day", "week", "month", "year" ], "type": "string", "description": "Filter posts by last hour, week, day, month or year" }, "includeNSFW": { "title": "Include NSFW content", "type": "boolean", "description": "You can choose to include or exclude NSFW content from your search", "default": true }, "maxItems": { "title": "Maximum number of items to be saved", "type": "integer", "description": "The maximum number of items that will be saved in the dataset. If you are scrapping for Communities&Users, remember to consider that each category inside a community is saved as a separated item.", "default": 10 }, "maxPostCount": { "title": "Limit of posts scraped inside a single page", "type": "integer", "description": "The maximum number of posts that will be scraped for each Posts Page or Communities&Users URL", "default": 10 }, "postDateLimit": { "title": "Post date limit", "type": "string", "description": "Use this value to only retrieve posts published after a specific date." }, "commentDateLimit": { "title": "Comment date limit", "type": "string", "description": "Use this value to only retrieve comments published after a specific date inside a post." }, "maxComments": { "title": "Limit of comments scraped inside a single page", "type": "integer", "description": "The maximum number of comments that will be scraped for each Comments Page. If you don't want to scrape comments you can set this to zero.", "default": 10 }, "maxCommunitiesCount": { "title": "Limit of `Communities`'s pages scraped", "type": "integer", "description": "The maximum number of `Communities`'s pages that will be scraped if your search or startUrl is a Communities type.", "default": 2 }, "maxUserCount": { "title": "Limit of `Users`'s pages scraped", "type": "integer", "description": "The maximum number of `Users`'s pages that will be scraped.", "default": 2 }, "scrollTimeout": { "title": "Page scroll timeout (seconds)", "type": "integer", "description": "Set the timeout in seconds in which the page will stop scrolling down to load new items", "default": 40 }, "navigationTimeout": { "title": "Navigation timeout (seconds)", "minimum": 20, "maximum": 60, "type": "integer", "description": "Set the navigation timeout in seconds for page loading", "default": 60 }, "maxRequestRetries": { "title": "Maximum request retries", "type": "integer", "description": "The maximum number of times the crawler will retry a failed request.", "default": 6 }, "proxy": { "title": "Proxy configuration", "type": "object", "description": "Either use Apify proxy, or provide your own proxy servers.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }, "debugMode": { "title": "Debug Mode", "type": "boolean", "description": "Activate to see detailed logs", "default": false } } }, "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 Reddit Scraper 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: