Skip to main content
Retrieve your Reddit watchlists with detailed information about tracked keywords and filtering rules.
Platform: Reddit. This endpoint lists Reddit watchlists only. LinkedIn keyword watchlists live behind GET /api-keyword-watchlist. See Choose a watchlist type.
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.
Extension requirement. Like all /api-reddit-watchlist methods, this call requires the team’s OutX Chrome extension to be installed and active, otherwise it returns 403 Plugin installation required.

Query Parameters

string
Watchlist ID. If omitted, returns all Reddit watchlists for your team.

Response Fields (All Watchlists)

array
Array of Reddit watchlist objects
number
Total number of Reddit watchlists for your team
boolean
Whether the watchlist is paused. A paused watchlist collects nothing, so a list that looks dead is often just disabled. Check this before debugging an empty feed.
string | null
ISO 8601 timestamp of when the watchlist was paused. null when the watchlist is active.

Response Fields (Single Watchlist)

string
Unique identifier for the watchlist
string
Watchlist name
string
URL-friendly slug for the watchlist
string
Always “reddit” for Reddit watchlists
array
Array of tracked keywords
number
Fetch frequency in hours
string | null
One-sentence objective used to score post relevance. null on watchlists created without one (a generated objective may appear a few seconds after create).
string | null
The natural-language prompt the watchlist was generated from, if any.
boolean
Whether the watchlist is paused. A disabled watchlist collects nothing, and PUT requests against it return 409 until it is re-enabled with disable: false. Present on both the list and the single-watchlist response.
string | null
When it was paused, as an ISO timestamp, or null when it is active. Returned on the list response only; the single-watchlist response carries disabled without it.
string | null
Slack webhook the watchlist notifies, if set.
string | null
ISO 8601 timestamp of the last completed fetch cycle. null if the watchlist has never synced.
array
Intent labels on the watchlist, always an array of { key, description, default } objects. Labels with default: true are the watchlist’s default feed filters, and what labels=default resolves to on /api-posts. The product marks up to two when it generates a taxonomy, but a watchlist can carry more or none: read the flags rather than assuming a count. See Intent labels & defaults.
array
Detailed tracking configuration for each keyword: id, primary_keyword, required_keywords, excluded_keywords, include_all_required, last_synced_at. Only on the single-watchlist response.

Error Responses

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.