Skip to main content
Retrieve your keyword watchlists with detailed information about tracked keywords and filtering rules.
Platform: LinkedIn. This endpoint lists LinkedIn keyword watchlists only. Reddit watchlists live behind GET /api-reddit-watchlist. To list everything your team tracks, call each type’s GET endpoint. See Choose a watchlist type.
To fetch the actual posts collected by a watchlist, use GET /api-posts with the watchlist’s id as watchlist_id.

​
Query Parameters

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

​
Response Fields (All Watchlists)

​
array
Array of watchlist objects
​
number
Total number of watchlists
​
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 “keyword” for keyword 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. Read this before patching labels so you can preserve current defaults. 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 keyword watchlists, call GET /api-keyword-watchlist without any parameters. To get a specific watchlist, pass the watchlist ID as a query parameter: GET /api-keyword-watchlist?id=YOUR_WATCHLIST_ID. The single-watchlist response includes more detail, such as the keyword_tracking array with full filtering rules.
When fetching all watchlists, you get a summary for each one including id, name, slug, type, fetchFreqInHours, keywords, createdAt, disabled, and disabledAt. When fetching a single watchlist by ID, you also get the keyword_tracking array, which contains detailed filtering configuration for each keyword including required_keywords and excluded_keywords.