# Reddit Search Scraper (`hakiiizimana/reddit-search`) Actor Search public Reddit posts by keyword, subreddit, sort order, and time range. Return clean, export-ready post data for market research, brand monitoring, product feedback, and content discovery. - **URL**: https://apify.com/hakiiizimana/reddit-search.md - **Developed by:** [Hussein Hakizimana](https://apify.com/hakiiizimana) (community) - **Categories:** Social media, Marketing, Lead generation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing from $1.50 / 1,000 reddit posts This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. - **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use). - **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`. - **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`. - **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`. - **Any other language** — the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ### Reddit Search Scraper Search public Reddit posts by keyword, subreddit, sort order, and time range. Get clean, export-ready results with the title, post text, author, subreddit, links, score, comments, timestamps, media, and moderation flags. Use it for customer research, market research, brand monitoring, product feedback, content discovery, and community research. No Reddit account or API key is required. One result is one post. Results are ready to read, filter, and download as JSON, CSV, HTML, or Excel. ### Why use it? - Find real customer complaints and feature requests. - Monitor a brand, product, or topic across Reddit. - Research communities before building or marketing something. - Collect posts for analysis without scrolling through Reddit manually. - Feed structured posts into your existing workflow. The result is simple: search in, useful Reddit posts out. ### How to run it 1. Open the Actor. 2. Enter a search query. 3. Optionally select a subreddit. 4. Pick the sort order and time range. 5. Set the maximum number of posts. 6. Run it and download the results. Start with a small result limit. You can always run it again with more posts. ### Input - **Search query** — required. Any normal Reddit search text. - **Subreddit** — optional. Use `typescript` or `r/typescript`. - **Sort results by** — relevance, hot, top, newest, or most comments. - **Time range** — hour, day, week, month, year, or all time. - **Maximum posts** — between 1 and 1,000 unique posts. ### Output One result equals one Reddit post. The fields are stable across post types, and missing values are `null`. This is a real record returned by the Actor: ````json { "id": "1vw07tl", "title": "What is the point of Typescript?", "body": "Typescript has a very impressive and elaborate type system, but at the same it does not play any role at \"compilation\" or \"transpilation\" time. \n\nHow does this differ from a glorified linter? \n\n```\nDeno 2.9.5\nexit using ctrl+d, ctrl+c, or close()\nREPL is running with all permissions allowed.\nTo specify permissions, run `deno repl` with allow flags.\n> const x: number = \"abc\"\nundefined\n> console.log(x)\nabc\nundefined\n> \n```\n\nBot of those variants lead to exactly the same javascript\n\n```\n\nconst lines: string[] = file1.split(\"\\n\")\n\nlines.forEach((line: string) => {\n console.log(\"line = %s\", line)\n \n})\n\nconst lines: ArrayLike<number> = file1.split(\"\\n\")\n\nlines.forEach((line: string) => {\n console.log(\"line = %s\", line)\n \n})\n```", "postType": "text", "author": "codingbliss12", "authorId": "2hik9yljdi", "authorUrl": "https://reddit.com/user/codingbliss12", "subreddit": "typescript", "subredditId": "2v6gg", "subredditUrl": "https://reddit.com/r/typescript/", "subredditSubscriberCount": 185326, "redditUrl": "https://reddit.com/r/typescript/comments/1vw07tl/what_is_the_point_of_typescript/", "externalUrl": null, "thumbnailUrl": null, "domain": "self.typescript", "flair": null, "createdAt": "2026-08-23T07:08:52.000Z", "editedAt": null, "score": 0, "upvoteRatio": 0.14, "commentCount": 70, "awardCount": 0, "crosspostCount": 0, "videoDurationSeconds": null, "isOriginalContent": false, "isNsfw": false, "isSpoiler": false, "isLocked": false, "isArchived": false, "isStickied": false, "isRemoved": false } ```` You can download the results as JSON, CSV, HTML, or Excel. ### Run output - **Reddit posts** — the normalized posts in the default dataset. - **Run summary** — the number of saved posts, pages requested, query, and subreddit filter used. ### Field guide | Fields | Meaning | | ---------------------------------------------- | ------------------------ | | `title`, `body`, `postType` | What the post is | | `author`, `authorId`, `authorUrl` | Who posted it | | `subreddit`, `subredditId`, `subredditUrl` | Where it was posted | | `score`, `upvoteRatio`, `commentCount` | Engagement | | `awardCount`, `crosspostCount` | Additional Reddit counts | | `redditUrl`, `externalUrl`, `thumbnailUrl` | Useful links | | `createdAt`, `editedAt` | ISO timestamps | | `isNsfw`, `isSpoiler`, `isLocked`, `isRemoved` | Post state | Missing values are `null`, not random empty strings. Dates are ISO-8601. Reddit prefixes such as `t3_` and `t5_` are removed from IDs. ### Pricing This Actor costs **$0.002 per saved post**, or **$2 per 1,000 results**, plus a small run-start charge. You pay for posts saved to the default dataset, not for empty results or unused result capacity. Start with 10 or 20 posts while testing a query, then increase the limit when the results look right. ### Limits This Actor searches public Reddit listings. Results can change as Reddit changes its ranking, removes posts, or applies rate limits. It does not search private communities or return authenticated-only data. ### FAQ, disclaimers, and support **Does this access private Reddit data?** No. It searches public listings only. Use the returned data responsibly and follow Reddit's Terms, applicable laws, and community rules. Do not use it for spam, harassment, or privacy-invasive profiling. Created and maintained by **Hussein Hakizimana**. If a result looks wrong, include the query, subreddit, sort order, and time range when reporting it. # Actor input Schema ## `query` (type: `string`): Words or a Reddit search expression to find in post titles and bodies. ## `subreddit` (type: `string`): Optional subreddit name, with or without the r/ prefix. ## `sort` (type: `string`): How Reddit should order matching posts. ## `time` (type: `string`): Time window used by Reddit for the selected sort mode. ## `maxItems` (type: `integer`): Maximum number of unique matching posts to save to the dataset. ## Actor input object example ```json { "query": "typescript", "subreddit": "", "sort": "relevance", "time": "all", "maxItems": 100 } ``` # Actor output Schema ## `results` (type: `string`): Every matching post saved as a normalized dataset item. ## `summary` (type: `string`): Counts and search settings for this run. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = {}; // Run the Actor and wait for it to finish const run = await client.actor("hakiiizimana/reddit-search").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = {} # Run the Actor and wait for it to finish run = client.actor("hakiiizimana/reddit-search").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}") for item in client.dataset(run.default_dataset_id).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{}' | apify call hakiiizimana/reddit-search --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,hakiiizimana/reddit-search" } } } ``` The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations). ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/UW1bYwNEQfEOAywW7/builds/Sigty9F8rI59WI3Xz/openapi.json