Platform: LinkedIn only. People watchlists track LinkedIn profiles; there is no Reddit equivalent. For topic tracking on LinkedIn use
/api-keyword-watchlist, on Reddit use /api-reddit-watchlist. See Choose a watchlist type.Query Parameters
string
Watchlist ID. If omitted, returns all people 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 “people” for people 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 profiles. This is the true total, even when
profiles was capped.array
The tracked profiles, oldest first (single-watchlist response only). Each entry has
id, full_name, headline, slug, urn, sales_urn, url, and status. Any of them except id can be null while enrichment is still filling the profile in.Capped at 1,000 entries per response. There is no paging on this field: read profiles_count for the real total and profiles_truncated to know whether you got everything.The 1,000 here is not the same number as the 200-profile cap the API enforces on a create or update. That cap is not retroactive, so a list built in the OutX app before the cap existed can still hold more than 200 profiles, and this endpoint reports what is actually there.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 profiles_count is larger than the number of entries in profiles, 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 people watchlists?
How do I get a specific watchlist versus all my people watchlists?
To get all people watchlists, call
GET /api-people-watchlist without any parameters. To get a specific watchlist, pass the watchlist ID as a query parameter: GET /api-people-watchlist?id=YOUR_WATCHLIST_ID. The single-watchlist response includes additional details like profiles_count, the profiles array of tracked profiles, 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 profiles_count (number of tracked profiles), the profiles array itself (capped at 1000), profiles_truncated, and the lists array with associated list details.