Skip to main content
Retrieve your people watchlists with detailed information about tracked profiles.
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)
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
Number of tracked profiles

Error Responses

Frequently Asked Questions

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 and associated lists.
When fetching all watchlists, you get a summary array with id, name, slug, type, and createdAt for each watchlist, plus a total count. When fetching a single watchlist by ID, you also get profiles_count (number of tracked profiles) and the lists array with associated list details.