Use the Reddit monitoring endpoint to track Reddit posts that match your keywords. Discover community discussions, brand mentions, and competitor activity across subreddits.
How it works
- Create a saved search via
POST /v1/searches/reddit/posts with your keywords
- Trigify checks Reddit on your configured frequency (
DAILY, WEEKLY, MONTHLY, or QUARTERLY; HOURLY is available on Enterprise and Custom plans only)
- New posts matching your keywords appear in your search results
- Optionally trigger workflows on new posts for alerts, enrichment, or integrations
Supported filters
| Field | Type | Required | Description |
|---|
name | string | Yes | A descriptive name for your saved search |
keywords | string[] | Yes | Keywords to search for (OR logic between keywords, minimum 1) |
keywords_and | string[] | No | All of these keywords must appear (AND logic) |
keywords_not | string[] | No | Exclude posts containing these keywords |
time_frame | string | No | How far back to search: past-24h, past-week, past-month, past-year, all-time |
max_results | number | No | Maximum posts to return per run (10-100, default: 50) |
frequency | string | No | How often to check: DAILY, WEEKLY, MONTHLY, QUARTERLY; HOURLY is Enterprise/Custom only |
The total number of keywords across keywords, keywords_and, and keywords_not must not exceed 10.
Use cases
- Community monitoring — Track discussions about your product or industry across relevant subreddits
- Brand mentions — Get alerted when your brand or product is mentioned in Reddit threads
- Competitor discussions — Monitor what users are saying about competitors to identify opportunities
Create a Reddit search
curl -X POST https://api.trigify.io/v1/searches/reddit/posts \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "SaaS Discussions",
"keywords": ["saas", "software as a service"],
"keywords_not": ["hiring", "job"],
"time_frame": "past-week",
"frequency": "DAILY",
"max_results": 50
}'
Example: Track product feedback
curl -X POST https://api.trigify.io/v1/searches/reddit/posts \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Product feedback on Reddit",
"keywords": ["trigify", "social listening tool"],
"keywords_and": ["review"],
"keywords_not": ["spam", "ad"],
"time_frame": "past-month",
"frequency": "WEEKLY",
"max_results": 30
}'
Response
GET /v1/searches/{id}/results returns Reddit posts in Trigify’s standard search result shape.
For the full shared response contract, see Get Search Results.
Preview your filters
Before committing to a saved search, POST the exact same body to POST /v1/searches/reddit/posts/preview to see a sample of matching posts. Useful for validating keyword combinations before spending a credit.
curl -X POST https://api.trigify.io/v1/searches/reddit/posts/preview \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Rust perf discussions",
"keywords": ["rust", "golang"],
"keywords_and": ["performance"],
"time_frame": "past-24h",
"max_results": 10
}'
Response shape mirrors GET /v1/searches/{id}/results plus a meta block with count, total_available, and monitoring_type.
Preview is free — no credit charged. Once you’re happy, POST the same body to /v1/searches/reddit/posts to commit the saved search.
Credit Usage
- 1 credit per search created
- Previewing filters via
POST /v1/searches/reddit/posts/preview is free
- Retrieving results via
GET /v1/searches/{id}/results is free
- Updating or deleting a search is free
- Subsequent runs on the configured frequency do not consume additional credits for search creation
Notes
- Keywords use OR logic by default. Use
keywords_and for AND logic
- Use
keywords_not to exclude irrelevant results (e.g. job posts, spam)
max_results must be between 10 and 100
HOURLY frequency requires an Enterprise or Custom plan