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.

Retrieve your Reddit watchlists with detailed information about tracked keywords and filtering rules. To fetch the actual Reddit posts collected by a watchlist, use GET /api-posts with the watchlist’s id as watchlist_id. The same endpoint serves LinkedIn and Reddit watchlists; the source is detected from the watchlist’s type.

​
Query Parameters

​
id
string
Watchlist ID. If omitted, returns all Reddit watchlists for your team.
curl -X GET \
  "https://api.outx.ai/api-reddit-watchlist" \
  -H "x-api-key: YOUR_API_KEY"

{
  "watchlists": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "Self-hosted CRM Threads",
      "slug": "self-hosted-crm-threads-550e8400",
      "type": "reddit",
      "fetchFreqInHours": 24,
      "keywords": ["crm", "indie hacker crm"],
      "createdAt": "2024-01-15T10:30:00Z"
    }
  ],
  "count": 1
}

​
Response Fields (All Watchlists)

​
watchlists
array
Array of Reddit watchlist objects
​
count
number
Total number of Reddit watchlists for your team

​
Response Fields (Single Watchlist)

​
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
​
keyword_tracking
array
Detailed tracking configuration for each keyword (only on the single-watchlist response)

​
Error Responses

Status CodeError MessageDescription
401Missing API Key / Invalid API KeyInvalid or missing API key
404Watchlist not found or access deniedWatchlist ID does not exist, is not a Reddit list, or is not yours

​
Frequently Asked Questions

To get all Reddit watchlists, call GET /api-reddit-watchlist without parameters. To get a specific watchlist, pass the watchlist ID as a query parameter: GET /api-reddit-watchlist?id=YOUR_WATCHLIST_ID. The single-watchlist response includes the keyword_tracking array with full filtering rules.
No. Reddit watchlists live behind /api-reddit-watchlist (filtered server-side to type=reddit), and keyword/people/company LinkedIn watchlists each have their own /api-*-watchlist endpoint. Calling this endpoint returns Reddit watchlists only.