Platform: Reddit. This endpoint lists Reddit watchlists only. LinkedIn keyword watchlists live behind
GET /api-keyword-watchlist. See Choose a watchlist type.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
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.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, as
{ key, description, default } objects. Labels with default: true (at most 2) are the watchlist’s default feed filters. 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
How do I get a specific watchlist versus all my Reddit watchlists?
How do I get a specific watchlist versus all my Reddit watchlists?
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.Are Reddit and LinkedIn watchlists returned by the same endpoint?
Are Reddit and LinkedIn watchlists returned by the same endpoint?
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.
