Reddit Scraper

Pricing

$29.00/month + usage

Try for free

Go to Apify Store

Reddit Scraper

Try for free

Scrape Reddit posts, comments, communities, and profiles via URLs or keyword searches. Features proxy rotation, custom field names, flexible filtering, and automatic retries. Perfect for monitoring, research, and data collection.

Pricing

$29.00/month + usage

Rating

5.0

(1)

Developer

scraping automation

Maintained by Community

Actor stats

Bookmarked

Total users

Monthly active users

5 days ago

Last modified

Categories

Lead generation

Jobs

Social media

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 Integrations settings in Apify Console.

Python

JavaScript

CLI

OpenAPI

HTTP

MCP

{
  "openapi": "3.0.1",
  "info": {
    "version": "0.2",
    "x-build-id": "SyuItADYzb2eaRHBI"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/runtime~reddit-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-runtime-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/runtime~reddit-scraper/runs": {
      "post": {
        "operationId": "runs-sync-runtime-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/runtime~reddit-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-runtime-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",
        "properties": {
          "startLinks": {
            "title": "Start links",
            "type": "array",
            "description": "Direct Reddit URLs (posts, users, communities, leaderboards, search results) to crawl.",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "searchQueries": {
            "title": "Search queries",
            "type": "array",
            "description": "Keywords to run through Reddit search when no start               @ links are supplied.",
            "items": {
              "type": "string"
            }
          },
          "searchScope": {
            "title": "Search scope",
            "enum": [
              "posts",
              "communities"
            ],
            "type": "string",
            "description": "Which tab of Reddit search results to crawl when search queries are used.",
            "default": "posts"
          },
          "sortOrder": {
            "title": "Sort order",
            "enum": [
              "relevance",
              "hot",
              "top",
              "new",
              "comments"
            ],
            "type": "string",
            "description": "Sorting applied to searches or feed style URLs.",
            "default": "relevance"
          },
          "timeWindow": {
            "title": "Time window",
            "enum": [
              "all",
              "hour",
              "day",
              "week",
              "month",
              "year"
            ],
            "type": "string",
            "description": "Temporal filter for searches (posts only).",
            "default": "all"
          },
          "totalItemCap": {
            "title": "Overall item limit",
            "minimum": 1,
            "type": "integer",
            "description": "Stops the run after this many dataset items have been stored.",
            "default": 100
          },
          "postCap": {
            "title": "Per feed post cap",
            "minimum": 1,
            "type": "integer",
            "description": "Maximum posts to take from a single subreddit/feed/user listing.",
            "default": 50
          },
          "commentCap": {
            "title": "Per post comment cap",
            "minimum": 0,
            "type": "integer",
            "description": "Maximum number of comments to fetch for each post.",
            "default": 25
          },
          "communityCap": {
            "title": "Community cap",
            "minimum": 0,
            "type": "integer",
            "description": "Maximum number of communities to take from leaderboards or searches.",
            "default": 25
          },
          "profileCap": {
            "title": "Profile cap",
            "minimum": 0,
            "type": "integer",
            "description": "Maximum number of user profiles to take from searches.",
            "default": 25
          },
          "leaderboardCap": {
            "title": "Leaderboard cap",
            "minimum": 0,
            "type": "integer",
            "description": "Number of leaderboard entries to collect when crawling /subreddits/leaderboard.",
            "default": 25
          },
          "scrollWaitSeconds": {
            "title": "Scroll wait (sec)",
            "minimum": 1,
            "type": "integer",
            "description": "How long to wait between dynamic pagination requests on infinite feeds.",
            "default": 30
          },
          "maxConcurrency": {
            "title": "Max concurrency",
            "minimum": 1,
            "type": "integer",
            "description": "Maximum number of parallel HTTP requests.",
            "default": 10
          },
          "useApifyProxy": {
            "title": "Use Apify Proxy",
            "type": "boolean",
            "description": "Whether to use Apify Proxy",
            "default": true
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Choose to use no proxy, Apify Proxy, or provide custom proxy URLs.",
            "default": {}
          },
          "extendResultFunction": {
            "title": "Extend result function",
            "type": "string",
            "description": "Javascript function executed for each dataset item. Receives { data, page } where data is the item object and page is always null (no browser context). Return an object to merge with the item."
          },
          "debugLog": {
            "title": "Verbose logging",
            "type": "boolean",
            "description": "When true, prints extra diagnostic information into the actor log.",
            "default": false
          },
          "minScore": {
            "title": "Minimum score",
            "minimum": 0,
            "type": "integer",
            "description": "Filter posts and comments by minimum score. Items with score below this value will be excluded. Leave empty to disable filtering."
          },
          "includeNSFW": {
            "title": "Include NSFW content",
            "type": "boolean",
            "description": "When false, excludes NSFW posts and communities from results.",
            "default": true
          },
          "logMetrics": {
            "title": "Log performance metrics",
            "type": "boolean",
            "description": "When true, logs performance statistics at the end of the run (items/sec, duration, errors).",
            "default": true
          },
          "enablePagination": {
            "title": "Enable pagination",
            "type": "boolean",
            "description": "When true, automatically paginates through listings to collect more items beyond the initial 100 items per request.",
            "default": false
          },
          "dateFrom": {
            "title": "Date from",
            "type": "string",
            "description": "Filter items created after this date (ISO 8601 format, e.g., 2024-01-01T00:00:00Z). Leave empty to disable."
          },
          "dateTo": {
            "title": "Date to",
            "type": "string",
            "description": "Filter items created before this date (ISO 8601 format, e.g., 2024-12-31T23:59:59Z). Leave empty to disable."
          },
          "enableDeduplication": {
            "title": "Enable deduplication",
            "type": "boolean",
            "description": "When true, prevents duplicate items (by entityId) from being added to the dataset within the same run.",
            "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}

Reddit Scraper OpenAPI definition

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:

OpenAPI.json

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:

Reddit Scraper API in Python

Reddit Scraper API in JavaScript

Reddit Scraper API through CLI

Reddit Scraper API

Reddit scraper

curious_coder/reddit-scraper

Scrape reddit posts and comments from reddit search and communities

Curious Coder

310

Reddit Posts Search Scraper

vulnv/reddit-posts-search-scraper

Search and scrape Reddit posts by keyword. Extract detailed post data, comments, scores, timestamps, and metadata for research and analysis.

VulnV

5.0

Reddit Data Extractor

techtechnicworld/reddit-data-extractor

Comprehensive Reddit data extraction tool that scrapes posts with comments and user profiles. Features advanced search, date filtering, NSFW control, and pagination. Perfect for sentiment analysis, market research, brand monitoring, and academic studies. Uses official Reddit JSON API.

techtechnicworld

5.0

Reddit Scraper for Comments, Posts, Communities, User & Listing

boneswill/reddit-scraper

This Reddit scraper easily extract posts, comments, communities, and user profiles. Customize your crawl limits, extract clean structured data, fast, reliable, and effortless. ⚡

succexx_DEV

5.0

Reddit Posts Search Scraper

easyapi/reddit-posts-search-scraper

Extract Reddit posts from search results with rich metadata, including media content, engagement metrics, and community information. Perfect for content research, trend analysis, and social media monitoring across Reddit communities.

EasyApi

122

5.0

Reddit Profile Crawler

crawlerbros/reddit-profile-crawler

Scrape reddit's profiles with posts and profile information.

Crawler Bros

5.0

Reddit API Scraper

comchat/reddit-api-scraper

Reddit Scraper is a powerful tool that allows you to extract data from Reddit such as posts by keyword. With Reddit Scraper, you can easily gather valuable information from Reddit without the need to log in. You can easily use this Reddit scraper as an alternative API.

Comchat

1.3K

1.0

Reddit Post Search

yesintelligent/reddit-post-search

Extract Reddit posts based on keywords, subreddit filters, and sorting options. Find relevant discussions, questions, and content from Reddit communities.

yesintelligent

Reddit Comments Search Scraper

easyapi/reddit-comments-search-scraper

Search and extract Reddit comments with advanced filtering options. Get detailed metadata including comment content, author info, post context, and engagement metrics. Perfect for sentiment analysis, trend research, and social media monitoring.

EasyApi

5.0

Reddit Scraper Pro

harshmaur/reddit-scraper-pro

Reddit Scraper Pro is a powerful, unlimited scraping for $20/mo for extracting data from Reddit. Scrape posts, users, comments, and communities with advanced search capabilities. Perfect for brand monitoring, trend tracking, and competitor research. Supports make, n8n integrations