> For the complete documentation index, see [llms.txt](https://ai-os-and-trend-finder.gitbook.io/ai-os-and-trend-finder-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ai-os-and-trend-finder.gitbook.io/ai-os-and-trend-finder-docs/docs/sources/source-compliance-reddit-subreddit-feed.md).

# Source Compliance: Reddit Subreddit Feed

> Implementation-time review completed 2026-05-27. Trend Finder has a configured Apify source declaration for public Reddit subreddit post feed metadata. This review is limited to post metadata with comments disabled.

***

## Source Overview

| Field                   | Value                                                                    |
| ----------------------- | ------------------------------------------------------------------------ |
| Source ID               | `reddit-ai-subreddit-feed`                                               |
| Source name             | Reddit subreddit feed                                                    |
| Primary Apify candidate | `clearpath/reddit-subreddit-posts-scraper`                               |
| Store page              | <https://apify.com/clearpath/reddit-subreddit-posts-scraper>             |
| Verified on             | 2026-05-27                                                               |
| Default build/tag       | `latest`, build `0.0.15`                                                 |
| Default run options     | 256 MB memory, 900 second Actor timeout                                  |
| Pricing observed        | Pay per event, posts around `$1.99 / 1,000`; comments charged separately |
| Trend Finder status     | Reviewed static declaration, fixture-backed normalizer coverage          |

The Actor input schema reviewed on 2026-05-27 exposes `subreddit`, `subreddits`, `subredditsFile`, `sort`, `timeFilter`, `maxPostsPerSubreddit`, `includeComments`, and `maxCommentsPerPost`. The reviewed Trend Finder starter input uses a small `subreddits` list, `sort: "rising"`, `maxPostsPerSubreddit: 10`, and `includeComments: false`.

## Terms And Use Boundary

The source is approved only for current public post metadata from named subreddits. It is not approval for comment collection, user profile collection, private subreddit collection, or persistent Reddit history. Apify storage, run IDs, Dataset IDs, and Apify-hosted item URLs are not durable browser evidence and must not be emitted to browser payloads.

Approved browser-safe evidence:

* Post title.
* Public Reddit post URL, full link, or permalink.
* Subreddit name or short flair/category context.
* Created timestamp.
* Public score mapped to `points`.
* Public comment count mapped to `comments`.

Excluded fields:

* Comment rows and comment bodies.
* `selftext`, body text, full post text, or copied discussion content.
* Authors, author IDs, author flair, profile URLs, avatars, and user metadata.
* Media URLs, thumbnails, award details, moderation fields, and crosspost payloads.
* Actor run URLs, Dataset IDs, or Apify-hosted item URLs.

## Retention And Attribution

| Policy               | Value                                                                                         |
| -------------------- | --------------------------------------------------------------------------------------------- |
| Storage location     | `src/data/live-data.json` and private cache snapshots                                         |
| Retention period     | `live-data.json` overwritten on each collection run; snapshots retained locally until deleted |
| Historical retention | Local snapshots only; no reviewed historical collection window                                |
| Deletion path        | Delete generated Trend Finder data and snapshots                                              |
| Attribution          | Show source ID `reddit-ai-subreddit-feed` and link to the public Reddit post                  |

## Historical Window Stance

| Field                  | Value                                                                  |
| ---------------------- | ---------------------------------------------------------------------- |
| Historical support     | Current-only                                                           |
| Source ID              | `reddit-ai-subreddit-feed`                                             |
| Safe override fields   | None                                                                   |
| Unsupported reason     | Feed modes are relative current views, not bounded historical windows. |
| Compliance declaration | `historicalWindowSupport.supported = false`                            |

Do not translate historical windows into Reddit `timeFilter` values. Those filters are relative views and apply only to some sort modes.

## Compliance Checklist

* [x] Current Apify Actor ID verified on 2026-05-27
* [x] Subreddit, sort, time filter, and comment toggle fields reviewed
* [x] Default build/tag and pricing model recorded
* [x] Post-metadata-only browser evidence boundary documented
* [x] Comments disabled in reviewed starter input
* [x] Comment rows rejected by fixture-backed tests
* [x] Apify storage excluded as durable browser evidence
* [x] Retention and deletion path documented
* [x] Attribution requirements documented
* [x] Historical-window stance recorded as current-only
* [x] Live tiny capped validation completed with credentials on 2026-05-27


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://ai-os-and-trend-finder.gitbook.io/ai-os-and-trend-finder-docs/docs/sources/source-compliance-reddit-subreddit-feed.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
