Skip to main content
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.
Plugin requirement. Like all /api-reddit-watchlist methods, this read requires at least one team member to have had the OutX browser extension active within the last 48 hours, otherwise it returns 403 Plugin installation required. Teams with global data sharing enabled are exempt.

​
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
403Plugin installation requiredNo team member has had the OutX browser extension active in the last 48 hours. Exempt if global data sharing is enabled.
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.