List Entities

Returns a paginated list of a watchlist's members. The shape of each entity follows the list kind: company lists return name and logo_url; people lists return first_name / last_name. The total is in meta.pagination.

List entities

GET/api/v2/watchlists/{kind}/{watchlist_id}/entities

Path parameters

Parameter	Type	Description
kind	string	Watchlist kind: `company` or `profile` (matches the list type).
watchlist_id	integer	Identifier of the watchlist.

Query parameters

Parameter	Type	Description
page	integer	Page number, starting at 1. Defaults to 1.
page_size	integer	Items per page. Defaults to 25, max 100.
q	string	Search term. Matches by name, LinkedIn handle, or (for people) current company. Case-insensitive, matches partial text, up to 255 characters.
response_format	enum	`concise`, `normalized` (default), or `detailed`.

Example request

curl "https://api.getsillage.com/api/v2/watchlists/company/128/entities?page=1&page_size=25&q=openai" \
  -H "Authorization: Bearer $SILLAGE_API_KEY"

Example response

{
  "data": [
    {
      "id": 901,
      "name": "OpenAI",
      "linkedin_handle": "openai",
      "linkedin_url": "https://www.linkedin.com/company/openai",
      "logo_url": "https://media.licdn.com/dms/image/openai-logo.png"
    }
  ],
  "meta": {
    "pagination": {
      "page": 1,
      "page_size": 25,
      "page_count": 1,
      "total": 12
    }
  }
}

Errors

Status	Description
401	The API key is missing or invalid.
404	The watchlist does not exist in your workspace.
422	Invalid `watchlist_id` or query parameters.
429	Too many requests.