Reddit Post Search

Affiliate disclosure: Some Apify links below include a referral parameter. TrueFetch may receive attribution if you sign up through those links, at no additional cost to you.

Reddit Post Search turns one keyword into structured Reddit post records from communities returned by Reddit search, with configurable sorting, a time window, source-reported engagement fields, moderation flags, media references, and an optional bounded comment sample.

• The input contract exposes five controls: one keyword, five sort modes, six time windows, a post cap, and an optional per-post comment cap.
• Each dataset row is documented with 34 top-level post fields, including the processor URL and a UTC processing timestamp.
• The same battery recycling scenario is shown for Console, API, MCP, and output inspection so the examples can be compared directly.
• All four referenced Apify schema types validate for this release: input, dataset, output, and key-value store.

Run a one-post test · View API options

For the smallest useful FREE-tier check, request one post and omit comments. One minimum start plus one returned post is configured at $0.01580. Search availability, rankings, visible fields, runtime, and live prices can change, so set a maximum total charge and inspect a small result before scaling.

What does Reddit Post Search do?

Reddit Post Search submits a keyword to Reddit search and returns matching posts as structured dataset rows. It is designed for questions that begin with a topic, product, organization, event, or phrase rather than a known username or a single known community. The Actor can sort the source search by relevance, hot, top, new, or comments and apply an all-time, hour, day, week, month, or year window.

Each returned row combines post text with its community context and public source signals. That includes the title, body, author, subreddit, subscriber count, source link, flair, timestamps, score-like values, status flags, media references, duplicate links, and processing provenance. When comments are requested, a bounded nested comment sample is attached to the corresponding post row.

The Actor does not interpret the records. It does not label sentiment, verify an author's identity, prove that a score represents unique people, or guarantee a stable ranking. It returns source records for a downstream research, review, moderation, archiving, or approved automation workflow.

How do I run Reddit Post Search?

Open the Actor input page, enter a keyword, choose the sort order and time window, set a small post limit, and decide whether comments are needed. A safe first run uses one post and no comments. Review that row before increasing either cap.

Use this input for the shared example:

{
  "keyword": "battery recycling",
  "sort_by": "relevance",
  "time_filter": "month",
  "max_posts": 1,
  "max_comments": 1
}

The first four fields are required. max_comments is optional; omit it or set it to 0 when post-level data is enough. A maximum is a request and billing boundary, not a promise that Reddit will expose that many matching records.

After the run finishes, open the default dataset and confirm the title, source link, subreddit, timestamps, flags, and any retained comments. Export only the fields and formats needed by the next step in your workflow.

What data does Reddit Post Search return?

The dataset schema documents 34 top-level fields. They are organized here by purpose:

• Provenance: processor, processed_at.
• Community: subreddit, subreddit_type, subreddit_subscribers.
• Identity and text: id, author, title, body, flair_text, link.
• Timing and engagement: created, edited, score, upvotes, downvotes, crossposts.
• State flags: archived, locked, stickied, pinned, hidden, over_18, spoiler, original, advertising, indexable, crosspostable, no_follow.
• Media and relationships: thumbnail, media_url, duplicates, comments.
• Additional source signal: content_score.

A representative row for the shared scenario looks like this. Values are examples of the schema, not a promise that the same live post will remain available:

{
  "processor": "https://apify.com/truefetch/reddit-post-search?fpr=aiagentapi",
  "processed_at": "2026-07-24T05:49:12+00:00",
  "subreddit": "StartUpIndia",
  "subreddit_type": "public",
  "subreddit_subscribers": 435738,
  "id": "1us0n5l",
  "author": "Small_Caramel4974",
  "created": "2026-07-10T12:00:00+00:00",
  "edited": null,
  "link": "https://www.reddit.com/r/StartUpIndia/comments/1us0n5l/",
  "flair_text": null,
  "title": "Thinking about getting into lithium battery recycling in India as a complete beginner. Looking for advice.",
  "body": "Post body as exposed by the source.",
  "score": 6,
  "upvotes": 6,
  "downvotes": 0,
  "crossposts": 0,
  "archived": false,
  "locked": false,
  "stickied": false,
  "pinned": false,
  "hidden": false,
  "over_18": false,
  "spoiler": false,
  "original": false,
  "advertising": false,
  "indexable": true,
  "crosspostable": true,
  "thumbnail": "self",
  "media_url": null,
  "no_follow": false,
  "content_score": 6,
  "duplicates": [],
  "comments": [
    {
      "id": "example-comment",
      "is_root": true,
      "author": "example-user",
      "body": "Example comment text",
      "score": 3,
      "reply_level": 0
    }
  ]
}

Reddit can approximate, hide, or change engagement values. Nulls and empty arrays are normal when a source field is unavailable, inapplicable, deleted, or not requested.

What inputs can I configure?

keyword is the required search string. Use a term that is specific enough to review but broad enough to return useful source results. Search operators and phrase combinations can change source behavior, so record the exact string with your analysis.

sort_by accepts relevance, hot, top, new, or comments. These modes request Reddit's ordering; they do not create a permanent ranking. time_filter accepts all, hour, day, week, month, or year and constrains the source search window.

max_posts is a required integer from 1 to 1,000,000. max_comments is an optional integer from 0 to 1,000,000 per returned post. Large accepted ceilings are not operational recommendations. Begin with one post and zero or one comment, check content suitability and cost, then increase gradually.

What platforms and markets does Reddit Post Search cover?

This Actor covers public records exposed through Reddit search across the communities that Reddit returns for the keyword. There is no country input and no promise of complete geographic coverage. A post's language, author location, or community focus must not be inferred solely from the subreddit name.

The Actor is not a general web search engine, private-community access tool, deleted-content recovery service, live firehose, or single-subreddit crawler. For a known account or community, use a more specific related Actor and compare its input contract before running.

Why use Reddit Post Search?

The main advantage is a reviewable, repeatable interface around a topic search. A saved input records the keyword, ordering, time window, and caps used for a snapshot. Dataset exports make it easier to compare selected fields, retain provenance, or pass records to another approved system without parsing a visual Reddit page.

Optional comments keep post-only research inexpensive while allowing a small discussion sample when context matters. The schema also separates source content from processing provenance, which helps analysts distinguish when the record was processed from when Reddit says the post was created.

Use the Actor as one evidence source. Sampling bias, ranking changes, moderation, deletions, private communities, and source availability can all affect what appears. Conclusions should be reviewed against the exact input, run time, and original links.

Who is Reddit Post Search for?

• Researchers collecting a bounded topic sample for qualitative review.
• Product and support teams examining public discussions around a defined phrase.
• Journalists or analysts preserving source links and timestamps for follow-up.
• Developers building approved ingestion, classification, or alerting workflows.
• Trust and safety teams reviewing public posts under an appropriate policy and legal basis.

It is not designed for harassment, deanonymization, credential collection, evasion of access controls, or high-stakes decisions about individuals. Apply data minimization, retention limits, human review, and applicable platform and privacy rules.

How can I use Reddit Post Search through the API or MCP?

The Actor can be started from the Console, Apify API, schedules, webhooks, or an MCP-capable client. The verified Actor ID for this listing is Xzx9cQ28OerGtBV3o, and the full Actor name is truefetch/reddit-post-search.

For a synchronous API call, set APIFY_TOKEN in your environment and run:

curl -X POST "https://api.apify.com/v2/acts/truefetch~reddit-post-search/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  --data '{"keyword":"battery recycling","sort_by":"relevance","time_filter":"month","max_posts":1,"max_comments":1}'

The equivalent API request body is:

{
  "keyword": "battery recycling",
  "sort_by": "relevance",
  "time_filter": "month",
  "max_posts": 1,
  "max_comments": 1
}

For MCP, connect an authorized client to Apify MCP, fetch Actor details first, inspect the current input schema, and then call truefetch/reddit-post-search with a bounded charge and runtime. The Actor input remains:

{
  "keyword": "battery recycling",
  "sort_by": "relevance",
  "time_filter": "month",
  "max_posts": 1,
  "max_comments": 1
}

Keep tokens in environment variables or a secret manager. Do not paste them into a README, dataset, issue, or shared prompt. A client plan can also restrict public Actor execution before a run starts; that host-level refusal is different from an Actor runtime failure.

How much does Reddit Post Search cost?

This release uses pay-per-event pricing. The start event depends on requested memory, with a minimum of one start event. A post event applies to each returned dataset post, and a comment event applies to each comment retained inside a post result. Confirm the live pricing page before production use.

Event	FREE	BRONZE	SILVER	GOLD / PLATINUM / DIAMOND
Actor Start, minimum	$0.01000	$0.01000	$0.01000	$0.01000
Returned post	$0.00580	$0.00561	$0.00541	$0.00522
Retained comment	$0.00015	$0.00015	$0.00014	$0.00014

At the FREE tier, one minimum start plus one returned post and one retained comment is $0.01000 + $0.00580 + $0.00015 = $0.01595. A no-result run can still incur the start event. More memory can increase start charges, and requested caps can multiply result events, so use maxTotalChargeUsd and small input caps.

How does Reddit Post Search compare with alternatives?

Manual Reddit search is convenient for reading a few results but is harder to reproduce or export consistently. A browser crawler can capture rendered pages, yet it usually requires more page-handling logic and may produce less stable field structure. A custom Reddit integration offers complete control but requires ongoing authentication, API, retry, storage, and schema maintenance.

Reddit Post Search is the middle option: a defined input, documented dataset, optional comments, API and MCP access, and event-based billing. Choose it when those properties match the workflow. Choose a community-specific Actor when the subreddit is already known, and choose a user-profile Actor when the username is the primary key.

What are the limits and troubleshooting steps?

• No results: broaden the keyword or time window and verify the same query at the source.
• Fewer rows than requested: the cap does not override Reddit availability, ranking, moderation, or access rules.
• Slow comment runs: retry with max_comments set to 0 or a small value; heavily discussed posts require more source work.
• Missing or null fields: inspect the original post because deleted authors, text-only posts, link posts, and moderation states expose different fields.
• Different repeated results: source rankings and visible activity can change between runs even with identical input.
• Charge limit reached: lower post and comment caps or raise the maximum total charge only after reviewing the live price.
• Public Actor rejected before start: confirm the MCP or Apify account plan permits public Actor runs.

Report a reproducible issue with the run ID, exact five-field input, expected behavior, and observed status. Remove tokens and unrelated personal information before sharing logs.

Frequently asked questions

Can I restrict the search to one subreddit?

There is no subreddit input in this Actor. Use a community-specific Actor when one known subreddit is the target.

Are comments required?

No. Omit max_comments or set it to 0 for post-only output. Comments are nested under each post when requested and available.

Does one post equal one unique topic?

No. Different posts can discuss the same subject, and the duplicates field can contain related source links. Deduplicate according to your research question.

Are scores exact vote counts?

Do not assume that. Reddit can obfuscate or change displayed engagement values. Treat them as source-reported signals at processing time.

Can I request one million posts?

The schema accepts that ceiling, but availability, cost, source behavior, runtime, and platform limits still apply. Start small and scale only after a successful bounded test.

Related TrueFetch Actors

• Reddit User Profile for one known username and optional activity samples.
• Reddit Community Profile for metadata about one known subreddit.
• Reddit Community Post for post collection from a known subreddit.

Support and last updated

Use the Actor issue page for a reproducible technical problem. For general questions, contact TrueFetch community support or direct support. Review Apify MCP documentation for client setup and authentication.

Last verified: July 23, 2026.

Run a one-post test · View API options