Platform: LinkedIn only. Company watchlists track LinkedIn company pages; there is no Reddit equivalent. Collection requires your team’s OutX Chrome extension to be installed and active (within the last 48 hours). See Choose a watchlist type.
Query Parameters
string
Watchlist ID. If omitted, returns all company watchlists for your team.
Response Fields
array
Array of watchlist objects (when fetching all)
string
When the watchlist was created. The list response spells this
created_at; the single-watchlist response spells the same value createdAt. Read whichever the call you made returns.number
Total number of watchlists (when fetching all)
string
Unique identifier for the watchlist
string
Watchlist name
string
URL-friendly slug
string
Always “company” for company watchlists
number
Fetch frequency in hours Lists created through the API before 2026-08-30 had no stored cadence and report 24, the scheduler’s fallback; set a value with PUT to change it.
number
Number of tracked companies. This is the true total, even when
companies was capped.array
The tracked companies, by name (single-watchlist response only). Each entry has
id, company_name, slug, urn, and url. Any of them except id can be null while enrichment is still filling the company in.Capped at 1000 companies per response. There is no paging on this field: read companies_count for the real total.Empty when the watchlist has no source list, or when the underlying list is not accessible, in which case members are omitted.boolean
true when companies_count is larger than the number of entries in companies, so you know the array is not the whole set.boolean
Whether the watchlist is paused. A disabled watchlist collects nothing. 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.Error Responses
Frequently Asked Questions
How do I get a specific watchlist versus all my company watchlists?
How do I get a specific watchlist versus all my company watchlists?
To get all company watchlists, call
GET /api-company-watchlist without any parameters. To get a specific watchlist, pass the watchlist ID as a query parameter: GET /api-company-watchlist?id=YOUR_WATCHLIST_ID. The single-watchlist response includes additional details like companies_count, the companies array of tracked company pages, and associated lists.What fields are returned in the response?
What fields are returned in the response?
When fetching all watchlists, you get a summary array with
id, name, slug, type, fetchFreqInHours, created_at, disabled and disabledAt for each watchlist, plus a total count. When fetching a single watchlist by ID, you also get companies_count (number of tracked companies), the companies array itself (capped at 1000), companies_truncated, and the lists array with associated list details.