Subreddit Posts Search Scraper

Search public Reddit posts by keyword inside specified subreddits. This actor returns one structured post record per result for community research, product discovery, brand monitoring, and AI-agent workflows.

Use this when you already know the communities to inspect. It does not discover subreddits, extract full comment threads, scrape user profiles, or access private content.

What you get

Each dataset record contains the public post title, body when available, author, subreddit, score, comment count, flair, permalink, external URL, flags, timestamp, query, requested subreddit, and provenance route.

Input

{
  "searchQuery": "artificial intelligence",
  "subreddits": ["technology", "MachineLearning"],
  "maxResults": 25,
  "sortBy": "relevance",
  "timeFilter": "month",
  "includeNsfw": false
}

Field	Required	Meaning
searchQuery	Yes	Keyword or phrase to find in public posts.
subreddits	Yes	One to 20 subreddit names, r/ names, or subreddit URLs.
maxResults	No	Total cap across all selected communities; default 25.
sortBy	No	relevance, new, top, comments, or hot.
timeFilter	No	hour, day, week, month, year, or all.
includeNsfw	No	Include NSFW-marked public posts; defaults to false.

Pricing

Pay per event plus Apify platform usage:

Event	Price
Post saved to dataset	$0.005

The actor logs its maximum event-cost cap before it fetches data. A post-found event is charged only after a complete validated record is persisted.

Outputs and outcomes

The dataset contains post records. OUTPUT stores a compact outcome and RUN_SUMMARY contains provider attempts, validation counts, warnings, and billing telemetry.

• COMPLETE: all requested work completed.
• PARTIAL: useful posts were saved but a provider or storage step failed.
• VALID_EMPTY: the selected communities were searched successfully but no posts matched.
• INVALID_INPUT: fix the query or subreddit list.
• UPSTREAM_FAILED or CONFIG_ERROR: no useful result could be produced; check RUN_SUMMARY.

Limitations and responsible use

This actor retrieves only public data made available by its configured providers. It cannot access private, deleted, quarantined, banned, or login-only Reddit content. Use the results only where your rights, approvals, and applicable law permit; do not use them to identify, harass, or de-anonymize people.