# Reddit Post Search (`truefetch/reddit-post-search`) Actor Cross-subreddit keyword search — post title, body, score, subreddit, author, and 40+ fields with optional comment threads. Up to 1,000,000 posts. $5.80 per 1,000. - **URL**: https://apify.com/truefetch/reddit-post-search.md - **Developed by:** [TrueFetch](https://apify.com/truefetch) (community) - **Categories:** Social media, News, Videos - **Stats:** 12 total users, 1 monthly users, 100.0% runs succeeded, 2 bookmarks - **User rating**: No ratings yet ## Pricing from $5.20 / 1,000 posts This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use 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 > **Affiliate disclosure:** Apify links on this page may include referral parameters. If you sign up through one of these links, TrueFetch may earn a commission from Apify at no extra cost to you. Pricing, features, and Actor access are unaffected. [![Reddit Post Search](https://img.shields.io/badge/Reddit%20Post%20Search-FF4500?style=for-the-badge&logo=reddit&logoColor=white)](https://apify.com/TrueFetch/reddit-post-search?fpr=aiagentapi) [![Reddit Keyword Scraper](https://img.shields.io/badge/Reddit%20Keyword%20Scraper-1F8A70?style=for-the-badge)](https://apify.com/TrueFetch/reddit-post-search?fpr=aiagentapi) [![$0.0058 per Post](https://img.shields.io/badge/$0.0058%20per%20Post-2E8B57?style=for-the-badge)](https://apify.com/TrueFetch/reddit-post-search?fpr=aiagentapi) [![Cross-Reddit Keyword Search](https://img.shields.io/badge/Cross--Reddit%20Keyword%20Search-555555?style=for-the-badge)](https://apify.com/TrueFetch/reddit-post-search?fpr=aiagentapi) [![Telegram Support](https://img.shields.io/badge/Telegram-Support-26A5E4?style=for-the-badge&logo=telegram&logoColor=white)](https://t.me/AiAgentApi) [![Telegram Group](https://img.shields.io/badge/Telegram-Group-26A5E4?style=for-the-badge&logo=telegram&logoColor=white)](https://t.me/Apify_Actor) ## Reddit Post Search — Reddit Keyword Scraper: Cross-Reddit Keyword Search **Enter any keyword and scrape Reddit posts from all subreddits — sorted by relevance, hot, top, new, or comments — with optional comment threads, 40+ fields per post, and up to 1 million results.** No login required. > **TL;DR (40-word answer):** Reddit Post Search is a no-login Apify Actor that searches Reddit by keyword and returns structured posts and optional comments at **$0.0058 per post + $0.00015 per comment**, with time filters and sort options for market research. Last verified 2026-05-02. > **What it is NOT:** Reddit Post Search is _not_ a single-subreddit scraper, _not_ a user profile tool, and _not_ a real-time stream — it searches all of Reddit by keyword and returns matching posts with optional comment threads. > **Reddit Post Search is an Apify Actor that accepts a search keyword and returns structured Reddit posts and comments matching that keyword across all subreddits.** Maintained by TrueFetch on the Apify Store. --- ### 🏷️ Why choose Reddit Post Search **Reddit Post Search is best for** market researchers, brand monitors, and NLP engineers who need cross-Reddit keyword search results with full post metadata and optional comment threads. - **📊 40+ fields per post** — title, body, author, score, upvotes, flair, media URL, timestamps, flags, and nested comment threads. - **🔍 Flexible search options** — sort by relevance, hot, top, new, or comments; filter by time period (hour, day, week, month, year, all). - **⚡ Pay-per-result pricing** — **$0.0058 per post** + **$0.00015 per comment**. Free Apify plan includes $5 monthly credits. --- ### 🚀 Quick Start — run in 3 steps #### Run in Apify Console 1. **Open the Actor** — go to [Reddit Post Search on Apify](https://apify.com/TrueFetch/reddit-post-search?fpr=aiagentapi) and click **Try for free**. 2. **Configure inputs** — enter a keyword, choose `sort_by` and `time_filter`, set `max_posts`, and optionally set `max_comments`. 3. **Click Start** — the Actor returns structured posts in the default dataset; download as JSON, CSV, or Excel. #### Run via Apify API ```bash curl -X POST "https://api.apify.com/v2/acts/TrueFetch~reddit-post-search/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "keyword": "python tutorial", "sort_by": "relevance", "time_filter": "month", "max_posts": 100, "max_comments": 5 }' ```` #### Run via MCP (for AI agents) Reddit Post Search is callable from Claude, ChatGPT, Cursor, and any MCP-compatible client through the [Apify MCP Server](https://docs.apify.com/platform/integrations/mcp?fpr=aiagentapi). Reference the Actor as `TrueFetch/reddit-post-search` and pass the same JSON input as above. *** ### ⚙️ Input parameters | Parameter | Type | Required | Default | Description | Example | | -------------- | ------- | :------: | ------- | ---------------------------------------------------------------------------- | ----------------- | | `keyword` | string | ✅ | — | Search query to find posts across all of Reddit. | `python tutorial` | | `sort_by` | string | ✅ | — | Result sort order: `relevance`, `hot`, `top`, `new`, or `comments`. | `relevance` | | `time_filter` | string | ✅ | — | Time period filter: `all`, `hour`, `day`, `week`, `month`, or `year`. | `month` | | `max_posts` | integer | ✅ | — | Number of posts to fetch. Range: 1–1,000,000. | `100` | | `max_comments` | integer | ❌ | `0` | Number of comments to fetch per post. Set to `0` to skip. Maximum 1,000,000. | `5` | ```json { "keyword": "python tutorial", "sort_by": "relevance", "time_filter": "month", "max_posts": 100, "max_comments": 5 } ``` *** ### 📦 Output dataset Each run writes structured post records (plus optional comment records) to the **default Apify dataset**, exportable as JSON, JSONL, CSV, Excel, XML, RSS, or via the dataset API. | Field | Type | Always present? | Description | Example | | -------------- | ------- | :-------------: | ------------------------------------------------------ | ------------------------------------------------ | | `processor` | string | ✅ | Apify Actor URL that produced this record. | `https://apify.com/TrueFetch/reddit-post-search` | | `processed_at` | string | ✅ | ISO 8601 UTC timestamp. | `2026-04-24T09:30:00+00:00` | | `subreddit` | string | optional | Subreddit where the post was found. | `learnpython` | | `id` | string | optional | Reddit post ID. | `1abc2de` | | `author` | string | optional | Post author username. | `u/some_user` | | `created` | string | optional | Post creation timestamp (UTC). | `2026-04-10T08:00:00+00:00` | | `title` | string | optional | Post title. | `Best Python tutorials for beginners` | | `body` | string | optional | Post body text (for text posts). | `I've been learning Python and found...` | | `score` | integer | optional | Post score (upvotes minus downvotes). | `1234` | | `upvotes` | integer | optional | Raw upvote count. | `1400` | | `downvotes` | integer | optional | Raw downvote count. | `166` | | `flair_text` | string | optional | Post flair label. | `Beginner` | | `media_url` | string | optional | External link or image URL. | `https://example.com/tutorial` | | `locked` | boolean | optional | Whether the post is locked for comments. | `false` | | `over_18` | boolean | optional | NSFW flag. | `false` | | `duplicates` | array | optional | URLs of crossposted versions. | `["https://..."]` | | `comments` | array | optional | Array of comment objects (author, body, score, depth). | `[{"author": "..."}]` | #### Sample output ```json { "processor": "https://apify.com/TrueFetch/reddit-post-search", "processed_at": "2026-04-24T09:30:00+00:00", "subreddit": "learnpython", "title": "Best Python tutorials for beginners", "author": "u/some_user", "score": 1234, "comments": [] } ``` *** ### 💡 Use cases #### For market researchers monitoring brand mentions across Reddit - **Problem:** a brand team needs to track all Reddit discussions mentioning their product name across all subreddits. - **How Reddit Post Search solves it:** run with the brand name as `keyword`, `sort_by: "new"`, `time_filter: "week"` on a schedule. - **Outcome:** automated brand monitoring at **$0.0058 per post**. #### For NLP researchers building Reddit training datasets - **Problem:** an ML team needs thousands of Reddit posts on a topic for fine-tuning a language model. - **How Reddit Post Search solves it:** run with a broad keyword and `max_posts: 10000` to collect bulk post titles and bodies. - **Outcome:** large-scale Reddit NLP dataset at ~$58 per 10,000 posts. #### For AI agents answering questions about Reddit discussions on a topic - **Problem:** LLM agents asked "what are people on Reddit saying about X?" cannot answer from stale training data. - **How Reddit Post Search solves it:** call the Actor over the [Apify MCP Server](https://docs.apify.com/platform/integrations/mcp?fpr=aiagentapi) to surface live Reddit search results. - **Outcome:** grounded Reddit data in production AI assistants. *** ### 💰 Pricing, limits, and performance | Fact | Value | | --------------------------- | --------------------------------------------------------------------------- | | Pricing model | Pay-per-result (events: `post` and `comment`) | | Per-post price | **$0.0058 per post = $5.80 per 1,000** | | Per-comment price | **$0.00015 per comment = $0.15 per 1,000** | | Free-tier monthly allowance | $5 Apify credits ≈ **~862 free posts** or **~33,333 free comments** / month | | Max posts per run | **1,000,000** | | Max comments per run | **1,000,000** | | Output fields per post | **40+** | | Login / cookies required | **No** — works without a Reddit account | | Export formats | JSON, JSONL, CSV, Excel, XML, RSS, dataset API | *** ### ⚖️ Compared with alternatives | Capability | **Reddit Post Search** | Reddit API (PRAW) | Custom scraper | | ------------------------------------------------------- | :--------------------: | :-------------------: | :------------------: | | Cross-subreddit keyword search with 40+ fields per post | ✅ | code required | you build & maintain | | Sort by relevance, hot, top, new, comments | ✅ | ✅ | you implement | | Pay-per-result pricing | **$0.0058 / post** | free but rate-limited | infra + dev cost | | Export to CSV / JSON | ✅ | ❌ | you implement | | Setup time to first result | **< 60 seconds** | hours | days–weeks | **Verdict.** Reddit Post Search is ideal for researchers and developers who need bulk Reddit keyword search results without managing Reddit API credentials or rate limits. *** ### ⚠️ Common mistakes to avoid 1. **Setting `max_posts` too high on first run.** Start with 100–500 posts to validate your keyword before scaling to millions. 2. **Forgetting `time_filter`.** Without time scoping, the Actor may return old posts. Use `time_filter: "week"` for recent discussions. 3. **Setting large `max_comments` unintentionally.** With `max_comments: 100` and `max_posts: 1000`, you could be charged for 100,000 comment records. *** ### 🛠️ Troubleshooting | Problem | Likely cause | Fix | | ------------------------- | ---------------------------------------------------------- | ---------------------------------------------------------------------- | | `Missing 'keyword' field` | Input is missing the `keyword` key. | Add `"keyword": "your search term"` to your input JSON. | | `Missing 'sort_by' field` | Input missing `sort_by`. | Set `sort_by` to one of: `relevance`, `hot`, `top`, `new`, `comments`. | | Empty dataset returned | Keyword has no matching posts in the selected time period. | Try a broader keyword or change `time_filter` to `all`. | | `Charge limit reached` | Account-level monthly spend limit hit. | Raise the run / monthly limit in your Apify plan settings. | *** ### ❓ FAQ #### What data does Reddit Post Search return? Reddit Post Search returns 40+ structured fields per post including title, body, author, subreddit, score, upvotes, flair, media URL, timestamps, and optional comment threads. #### How much does Reddit Post Search cost? The Actor charges **$0.0058 per post** and **$0.00015 per comment**. The Apify Free plan includes $5 of monthly platform credits. #### Does Reddit Post Search require a login? No. Reddit Post Search uses the Reddit API without requiring a user login or cookies. #### Can I search only within a specific subreddit? Use [Reddit Community Post](https://apify.com/TrueFetch/reddit-community-post?fpr=aiagentapi) to scrape posts from a single subreddit. Reddit Post Search searches across all of Reddit. *** ### 🔌 Integrations Reddit Post Search plugs straight into the Apify ecosystem: - **Schedules** — monitor keyword trends on a recurring schedule ([docs](https://docs.apify.com/platform/schedules?fpr=aiagentapi)). - **Webhooks** — POST results to your endpoint on `ACTOR.RUN.SUCCEEDED` ([docs](https://docs.apify.com/platform/integrations/webhooks?fpr=aiagentapi)). - **Apify API** — `run-sync-get-dataset-items` for blocking calls, `runs` for async ([docs](https://docs.apify.com/api/v2?fpr=aiagentapi)). - **MCP Server** — call the Actor from Claude, ChatGPT, or Cursor agents ([docs](https://docs.apify.com/platform/integrations/mcp?fpr=aiagentapi)). - **No-code** — Make, Zapier, n8n, Pipedream, Google Sheets, Airtable. *** ### 🧱 Sister Actors from TrueFetch #### Jobs - [Best Job Search](https://apify.com/TrueFetch/best-job-search?fpr=aiagentapi) - [Glassdoor Job Search](https://apify.com/TrueFetch/glassdoor-job-search?fpr=aiagentapi) - [Glints Company Finder](https://apify.com/TrueFetch/glints-company-finder?fpr=aiagentapi) - [Glints Job Finder](https://apify.com/TrueFetch/glints-job-finder?fpr=aiagentapi) - [Indeed Job Search](https://apify.com/TrueFetch/indeed-job-search?fpr=aiagentapi) - [JobStreet Company Finder](https://apify.com/TrueFetch/jobstreet-company-finder?fpr=aiagentapi) - [JobStreet Job Finder](https://apify.com/TrueFetch/jobstreet-job-finder?fpr=aiagentapi) - [LinkedIn Job Search](https://apify.com/TrueFetch/linkedin-job-search?fpr=aiagentapi) - [StepStone Company Finder](https://apify.com/TrueFetch/stepstone-company-finder?fpr=aiagentapi) - [StepStone Job Finder](https://apify.com/TrueFetch/stepstone-job-finder?fpr=aiagentapi) #### Shopping & Deals - [Amazon Deals Scraper](https://apify.com/TrueFetch/amazon-deals-scraper?fpr=aiagentapi) - [Amazon Store Finder](https://apify.com/TrueFetch/amazon-store-finder?fpr=aiagentapi) - [Argos Deals Scraper](https://apify.com/TrueFetch/argos-deals-scraper?fpr=aiagentapi) - [ASOS Fashion Scraper](https://apify.com/TrueFetch/asos-fashion-scraper?fpr=aiagentapi) - [eBay Deals Scraper](https://apify.com/TrueFetch/ebay-deals-scraper?fpr=aiagentapi) - [eBay Seller Finder](https://apify.com/TrueFetch/ebay-seller-finder?fpr=aiagentapi) - [Flipkart Deals Scraper](https://apify.com/TrueFetch/flipkart-deals-scraper?fpr=aiagentapi) - [John Lewis Deals Scraper](https://apify.com/TrueFetch/john-lewis-deals-scraper?fpr=aiagentapi) - [Lidl Deals Scraper](https://apify.com/TrueFetch/lidl-deals-scraper?fpr=aiagentapi) - [Magalu Deals Scraper](https://apify.com/TrueFetch/magalu-deals-scraper?fpr=aiagentapi) - [MediaMarkt Deals Scraper](https://apify.com/TrueFetch/mediamarkt-deals-scraper?fpr=aiagentapi) - [Mercado Livre Deals Scraper](https://apify.com/TrueFetch/mercado-livre-deals-scraper?fpr=aiagentapi) - [Nykaa Beauty Scraper](https://apify.com/TrueFetch/nykaa-beauty-scraper?fpr=aiagentapi) - [OTTO Deals Scraper](https://apify.com/TrueFetch/otto-deals-scraper?fpr=aiagentapi) - [Target Deals Scraper](https://apify.com/TrueFetch/target-deals-scraper?fpr=aiagentapi) - [TradeIndia Product Finder](https://apify.com/TrueFetch/tradeindia-product-finder?fpr=aiagentapi) - [TradeIndia Supplier Finder](https://apify.com/TrueFetch/tradeindia-supplier-finder?fpr=aiagentapi) - [Walmart Deals Scraper](https://apify.com/TrueFetch/walmart-deals-scraper?fpr=aiagentapi) #### Vehicles - [AutoTrader Car Finder](https://apify.com/TrueFetch/autotrader-car-finder?fpr=aiagentapi) - [AutoTrader Dealer Finder](https://apify.com/TrueFetch/autotrader-dealer-finder?fpr=aiagentapi) - [Cars.com Car Finder](https://apify.com/TrueFetch/carscom-car-finder?fpr=aiagentapi) - [Cars.com Dealer Finder](https://apify.com/TrueFetch/carscom-dealer-finder?fpr=aiagentapi) - [Webmotors Car Finder](https://apify.com/TrueFetch/webmotors-car-finder?fpr=aiagentapi) #### Real Estate - [MagicBricks Builder Finder](https://apify.com/TrueFetch/magicbricks-builder-finder?fpr=aiagentapi) - [MagicBricks Home Finder](https://apify.com/TrueFetch/magicbricks-home-finder?fpr=aiagentapi) - [US Real Estate](https://apify.com/TrueFetch/us-real-estate?fpr=aiagentapi) - [Zillow Real Estate](https://apify.com/TrueFetch/zillow-real-estate?fpr=aiagentapi) #### Local Business & Food - [BBB Business Finder](https://apify.com/TrueFetch/bbb-business-finder?fpr=aiagentapi) - [BBB Review Checker](https://apify.com/TrueFetch/bbb-review-checker?fpr=aiagentapi) - [Google Business Profile](https://apify.com/TrueFetch/google-business-profile?fpr=aiagentapi) - [Reclame Aqui Company Finder](https://apify.com/TrueFetch/reclame-aqui-company-finder?fpr=aiagentapi) - [Zomato Menu Checker](https://apify.com/TrueFetch/zomato-menu-checker?fpr=aiagentapi) - [Zomato Restaurant Finder](https://apify.com/TrueFetch/zomato-restaurant-finder?fpr=aiagentapi) #### Classifieds - [Kleinanzeigen Listing Finder](https://apify.com/TrueFetch/kleinanzeigen-listing-finder?fpr=aiagentapi) - [Kleinanzeigen Seller Finder](https://apify.com/TrueFetch/kleinanzeigen-seller-finder?fpr=aiagentapi) - [OLX Listing Finder](https://apify.com/TrueFetch/olx-listing-finder?fpr=aiagentapi) - [OLX Seller Finder](https://apify.com/TrueFetch/olx-seller-finder?fpr=aiagentapi) #### Social Media - [Find Any Company On LinkedIn](https://apify.com/TrueFetch/find-any-company-on-linkedin?fpr=aiagentapi) - [Find Anyone On LinkedIn](https://apify.com/TrueFetch/find-anyone-on-linkedin?fpr=aiagentapi) - [Instagram Explore](https://apify.com/TrueFetch/instagram-explore?fpr=aiagentapi) - [Instagram Post](https://apify.com/TrueFetch/instagram-post?fpr=aiagentapi) - [Instagram Profile](https://apify.com/TrueFetch/instagram-profile?fpr=aiagentapi) - [Reddit Community Post](https://apify.com/TrueFetch/reddit-community-post?fpr=aiagentapi) - [Reddit Community Profile](https://apify.com/TrueFetch/reddit-community-profile?fpr=aiagentapi) - [Reddit Community User](https://apify.com/TrueFetch/reddit-community-user?fpr=aiagentapi) - [Reddit Post Search](https://apify.com/TrueFetch/reddit-post-search?fpr=aiagentapi) - [Reddit User Profile](https://apify.com/TrueFetch/reddit-user-profile?fpr=aiagentapi) - [Social Media Marketing](https://apify.com/TrueFetch/social-media-marketing?fpr=aiagentapi) - [Telegram Channel Message](https://apify.com/TrueFetch/telegram-channel-message?fpr=aiagentapi) - [Telegram Group Member](https://apify.com/TrueFetch/telegram-group-member?fpr=aiagentapi) - [Telegram Profile](https://apify.com/TrueFetch/telegram-profile?fpr=aiagentapi) - [X Community Profile](https://apify.com/TrueFetch/x-community-profile?fpr=aiagentapi) - [X User Profile](https://apify.com/TrueFetch/x-user-profile?fpr=aiagentapi) #### Videos & Text - [Best Video Downloader](https://apify.com/TrueFetch/best-video-downloader?fpr=aiagentapi) - [Instagram To Text](https://apify.com/TrueFetch/instagram-to-text?fpr=aiagentapi) - [TikTok Live Recorder](https://apify.com/TrueFetch/tiktok-live-recorder?fpr=aiagentapi) - [TikTok Video Downloader](https://apify.com/TrueFetch/tiktok-video-downloader?fpr=aiagentapi) - [TikTok Video Lookup](https://apify.com/TrueFetch/tiktok-video-lookup?fpr=aiagentapi) - [Video Subtitles Downloader](https://apify.com/TrueFetch/video-subtitles-downloader?fpr=aiagentapi) - [Video To Text](https://apify.com/TrueFetch/video-to-text?fpr=aiagentapi) - [YouTube Niche Scraper](https://apify.com/TrueFetch/youtube-niche-scraper?fpr=aiagentapi) - [YouTube Video Downloader](https://apify.com/TrueFetch/youtube-video-downloader?fpr=aiagentapi) #### Content & Articles - [Medium Article Finder](https://apify.com/TrueFetch/medium-article-finder?fpr=aiagentapi) - [Medium Writer Finder](https://apify.com/TrueFetch/medium-writer-finder?fpr=aiagentapi) *** ### 📞 Support, changelog, last updated #### Support - 💬 **Telegram Group:** [t.me/Apify\_Actor](https://t.me/Apify_Actor) - 📧 **Direct support:** [t.me/AiAgentApi](https://t.me/AiAgentApi) - 📖 **Actor page & docs:** [apify.com/TrueFetch/reddit-post-search](https://apify.com/TrueFetch/reddit-post-search?fpr=aiagentapi) Maintained by **TrueFetch** on the [Apify Store](https://apify.com/TrueFetch?fpr=aiagentapi). > **Cost of doing nothing:** manually searching Reddit by keyword and collecting post metadata is a slow, repetitive task. Reddit Post Search delivers structured results at $0.0058 per post via API. → [Try it free with $5 of Apify credits](https://apify.com/TrueFetch/reddit-post-search?fpr=aiagentapi). #### Changelog - **2026-05-02** — README rewritten for SEO + GEO; documented all output fields, pricing, troubleshooting matrix, and FAQ. - **2026-04** — Increased `max_posts` limit to 1,000,000. - **2026-02** — Initial release: Reddit cross-subreddit keyword post scraper. *** ```json { "@context": "https://schema.org", "@graph": [ { "@type": "SoftwareApplication", "@id": "https://apify.com/TrueFetch/reddit-post-search#software", "name": "Reddit Post Search", "description": "Apify Actor that searches Reddit by keyword and returns structured posts and optional comments at $0.0058 per post with sort and time filter options.", "applicationCategory": "BusinessApplication", "operatingSystem": "Web, Cloud", "url": "https://apify.com/TrueFetch/reddit-post-search", "offers": { "@type": "Offer", "price": "0.0058", "priceCurrency": "USD", "availability": "https://schema.org/InStock" }, "author": { "@id": "https://apify.com/TrueFetch#author-TrueFetch" }, "publisher": { "@id": "https://apify.com/TrueFetch#publisher" } }, { "@type": "Organization", "@id": "https://apify.com/TrueFetch#publisher", "name": "TrueFetch", "url": "https://apify.com/TrueFetch", "sameAs": ["https://t.me/Apify_Actor", "https://t.me/AiAgentApi"] }, { "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "What data does Reddit Post Search return?", "acceptedAnswer": { "@type": "Answer", "text": "Reddit Post Search returns 40+ structured fields per post including title, body, author, subreddit, score, upvotes, flair, media URL, timestamps, and optional comment threads." } }, { "@type": "Question", "name": "How much does Reddit Post Search cost?", "acceptedAnswer": { "@type": "Answer", "text": "Reddit Post Search charges $0.0058 per post and $0.00015 per comment. The Apify Free plan includes $5 of monthly platform credits." } }, { "@type": "Question", "name": "Can I search only within a specific subreddit?", "acceptedAnswer": { "@type": "Answer", "text": "Use Reddit Community Post (apify.com/TrueFetch/reddit-community-post) to scrape posts from a single subreddit. Reddit Post Search searches across all of Reddit." } } ] }, { "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "Apify", "item": "https://apify.com" }, { "@type": "ListItem", "position": 2, "name": "Social Media", "item": "https://apify.com/store?category=SOCIAL_MEDIA" }, { "@type": "ListItem", "position": 3, "name": "Reddit Post Search", "item": "https://apify.com/TrueFetch/reddit-post-search" } ] } ] } ``` *** **Last Updated:** May 2, 2026 **Schema version:** 1.1 **Maintained by:** [TrueFetch](https://apify.com/TrueFetch?fpr=aiagentapi) · 💬 [Telegram Group](https://t.me/Apify_Actor) · 📧 [Support](https://t.me/AiAgentApi) # Actor input Schema ## `keyword` (type: `string`): Search keyword to find Reddit posts across all subreddits ## `sort_by` (type: `string`): Sort results by relevance, hot, top, new, or comment count ## `time_filter` (type: `string`): Filter results to posts published within a set time period ## `max_posts` (type: `integer`): Maximum number of posts to find per search ## `max_comments` (type: `integer`): Maximum number of comments to get per post, 0 to skip ## Actor input object example ```json { "keyword": "marketing", "sort_by": "relevance", "time_filter": "all", "max_posts": 1 } ``` # Actor output Schema ## `results` (type: `string`): Reddit posts matching keyword search with comments, votes, and community details # 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 = { "keyword": "marketing", "sort_by": "relevance", "time_filter": "all", "max_posts": 1, "max_comments": 0 }; // Run the Actor and wait for it to finish const run = await client.actor("truefetch/reddit-post-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 = { "keyword": "marketing", "sort_by": "relevance", "time_filter": "all", "max_posts": 1, "max_comments": 0, } # Run the Actor and wait for it to finish run = client.actor("truefetch/reddit-post-search").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "keyword": "marketing", "sort_by": "relevance", "time_filter": "all", "max_posts": 1, "max_comments": 0 }' | apify call truefetch/reddit-post-search --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=truefetch/reddit-post-search", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Reddit Post Search", "description": "Cross-subreddit keyword search — post title, body, score, subreddit, author, and 40+ fields with optional comment threads. Up to 1,000,000 posts. $5.80 per 1,000.", "version": "1.0", "x-build-id": "AhjKHFaeKcAjYXUsm" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/truefetch~reddit-post-search/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-truefetch-reddit-post-search", "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/truefetch~reddit-post-search/runs": { "post": { "operationId": "runs-sync-truefetch-reddit-post-search", "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/truefetch~reddit-post-search/run-sync": { "post": { "operationId": "run-sync-truefetch-reddit-post-search", "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": [ "keyword", "sort_by", "time_filter", "max_posts" ], "properties": { "keyword": { "title": "Keyword", "type": "string", "description": "Search keyword to find Reddit posts across all subreddits" }, "sort_by": { "title": "Sort By", "enum": [ "relevance", "hot", "top", "new", "comments" ], "type": "string", "description": "Sort results by relevance, hot, top, new, or comment count" }, "time_filter": { "title": "Time Filter", "enum": [ "all", "hour", "day", "week", "month", "year" ], "type": "string", "description": "Filter results to posts published within a set time period" }, "max_posts": { "title": "Max Posts", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Maximum number of posts to find per search" }, "max_comments": { "title": "Max Comments", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Maximum number of comments to get per post, 0 to skip" } } }, "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 } } } } } } } } } } ```