Skip to main content

Documentation Index

Fetch the complete documentation index at: https://www.outx.ai/docs/llms.txt

Use this file to discover all available pages before exploring further.

Track Reddit posts and comments containing specific keywords with the same filtering primitives as keyword watchlists. Useful for monitoring subreddit conversations, indie-hacker chatter, support requests, and competitor mentions across Reddit. The endpoint accepts two body shapes. Pass either keywords (direct mode, documented below) or prompt (AI mode, documented in Prompt mode at the bottom of this page), not both.

​
Request Body (direct keywords mode)

​
name
string
Watchlist name. If not provided, a name will be auto-generated based on keywords.
​
keywords
array
required
Array of keywords to track on Reddit. Can be simple strings or advanced keyword objects with filtering rules.Simple format:
["self-hosted", "open source crm", "indie hacker"]
Advanced format with filters:
[
  {
    "keyword": "crm",
    "required_keywords": ["self-hosted", "open source"],
    "excluded_keywords": ["enterprise", "salesforce"]
  }
]
​
description
string
Optional description for the watchlist
​
labels
array
Custom labels (intent categories) for organization. Same shape as keyword watchlists.
[
  {
    "name": "buying intent",
    "description": "Threads asking for tool recommendations"
  }
]
​
fetchFreqInHours
number
default:"24"
Fetch frequency in hours. Allowed values: 1, 3, 6, 12, 24, 48, 72. Reddit watchlists default to 24 (less frequent than LinkedIn since Reddit threads update more slowly).

​
Advanced Keyword Filtering

Each keyword can have additional filtering rules:
​
keyword
string
required
The primary keyword to search for in Reddit posts and comments
​
required_keywords
array
All of these keywords must be present in the post (AND logic)
​
excluded_keywords
array
None of these keywords should be present in the post (NOT logic)
curl -X POST \
  "https://api.outx.ai/api-reddit-watchlist" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "name": "Self-hosted CRM Threads",
    "keywords": [
      {
        "keyword": "crm",
        "required_keywords": ["self-hosted", "open source"],
        "excluded_keywords": ["salesforce", "enterprise"]
      },
      "indie hacker crm"
    ],
    "description": "Track Reddit threads about self-hosted CRM tools",
    "labels": [
      {
        "name": "buying intent",
        "description": "Threads asking for tool recommendations"
      }
    ],
    "fetchFreqInHours": 12
  }'

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "Self-hosted CRM Threads",
  "slug": "self-hosted-crm-threads-550e8400",
  "type": "reddit",
  "keywords": ["crm", "indie hacker crm"],
  "fetchFreqInHours": 12,
  "created": true,
  "results": [
    {
      "success": true,
      "keyword": "crm",
      "keyword_id": "660e8400-e29b-41d4-a716-446655440001"
    }
  ]
}

​
Idempotency

POST is idempotent on the keyword set. If your team already has a Reddit watchlist whose primary keywords match the request exactly (order-insensitive, lower-cased, trimmed), the existing watchlist is returned with:
  • HTTP status 200 OK (instead of 201 Created)
  • created: false
  • The existing watchlist’s fetchFreqInHours and labels are returned, your request’s values are ignored for the duplicate match.
Use this to safely retry creations without hitting the plan-watchlist limit. The plan check is only applied when a brand-new watchlist would be created.

​
Response Fields

​
id
string
Unique identifier for the watchlist
​
name
string
Watchlist name
​
slug
string
URL-friendly slug for the watchlist
​
type
string
Always “reddit” for Reddit watchlists
​
keywords
array
Array of tracked keywords
​
fetchFreqInHours
number
Fetch frequency in hours
​
created
boolean
true when a new watchlist was created (status 201), false when an existing watchlist with the same keyword set was returned (status 200).
​
results
array
Array of keyword creation results

​
Error Responses

Status CodeError MessageDescription
400Either keywords array or prompt string is requiredNo keywords or prompt was supplied
400Provide either keywords or prompt, not bothBoth modes were supplied at once
400Invalid fetchFreqInHours valueFetch frequency must be one of: 1, 3, 6, 12, 24, 48, 72
401Missing API Key / Invalid API KeyInvalid or missing API key
402Plan limit reachedFree or paid plan watchlist quota exceeded

​
Use Cases

Catch threads where people ask for tool recommendations:
{
  "name": "CRM Buying Threads",
  "keywords": [
    {
      "keyword": "crm",
      "required_keywords": ["recommend", "looking for", "alternatives"]
    }
  ]
}
Watch for Reddit posts that name a competitor:
{
  "name": "Competitor Mentions on Reddit",
  "keywords": [
    {
      "keyword": "CompetitorName",
      "excluded_keywords": ["partnership", "ad"]
    }
  ],
  "fetchFreqInHours": 12
}
Surface posts in indie-hacker spaces:
{
  "name": "Indie Hacker Reddit",
  "keywords": ["indie hacker", "side project", "bootstrapped saas"]
}

​
Prompt mode

Skip the keyword brainstorming and let OutX generate keywords and intent labels for you. Send a single prompt field describing what you want to track in plain English. OutX creates the watchlist immediately and runs keyword and label generation in the background.

​
Request Body

​
prompt
string
required
Plain-English description of what to track on Reddit. URLs are allowed; OutX fetches page metadata to improve keyword quality.Examples:
  • "Self-hosted CRM tools and competitors like NocoCRM, EspoCRM, Twenty"
  • "People asking for indie-friendly database hosting"
  • "Mentions of our product Acme on r/SaaS, r/indiehackers"
​
name
string
Optional watchlist name. Auto-generated from the prompt if omitted.
​
fetchFreqInHours
number
default:"24"
Fetch frequency in hours. Allowed values: 1, 3, 6, 12, 24, 48, 72.
curl -X POST \
  "https://api.outx.ai/api-reddit-watchlist" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "prompt": "Track Reddit threads about self-hosted CRMs and indie SaaS founders looking for alternatives to Salesforce",
    "name": "Self-hosted CRM Reddit",
    "fetchFreqInHours": 24
  }'

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "Self-hosted CRM Reddit",
  "slug": "self-hosted-crm-reddit-550e8400",
  "type": "reddit",
  "fetchFreqInHours": 24,
  "prompt": "Track Reddit threads about self-hosted CRMs and indie SaaS founders looking for alternatives to Salesforce",
  "created": true,
  "message": "Watchlist created. Keywords and labels are being generated in the background and will be available shortly."
}
Keywords and intent labels populate on the watchlist a few seconds after creation. Use Get Reddit Watchlist to fetch the latest state.

​
Frequently Asked Questions

Both share the same keyword and label primitives. The difference is the source: keyword watchlists scan LinkedIn posts, Reddit watchlists scan Reddit posts and comments. The default fetch frequency is also higher (24h vs 12h) since Reddit threads update on a slower cadence.
Today, Reddit watchlists are keyword-driven and search across Reddit, not scoped to a subreddit list. To bias toward a subreddit, mention it in your prompt ("Track posts in r/SaaS about ...") so the AI keyword generator picks up subreddit-specific vocabulary.
Tracking begins immediately after creation. OutX scans Reddit on the next fetch cycle, based on the fetchFreqInHours value you set. Default is 24 hours.
When you reach the maximum number of watchlists allowed by your plan (across keyword, people, company, and reddit types combined), the API returns 402. You can either delete an existing watchlist to free up a slot, or upgrade your plan for higher limits.