List Entities

Returns a paginated list of a watchlist's members. The shape of each entity follows the list kind: company lists return name; 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.
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" \
  -H "Authorization: Bearer $SILLAGE_API_KEY"

const response = await fetch(
  'https://api.getsillage.com/api/v2/watchlists/company/128/entities?page=1&page_size=25',
  {
    headers: { Authorization: `Bearer ${process.env.SILLAGE_API_KEY}` },
  },
)

const result = await response.json()

import { request } from 'node:https'

const req = request(
  new URL(
    'https://api.getsillage.com/api/v2/watchlists/company/128/entities?page=1&page_size=25',
  ),
  { headers: { Authorization: `Bearer ${process.env.SILLAGE_API_KEY}` } },
  (res) => {
    let data = ''
    res.on('data', (chunk) => {
      data += chunk
    })
    res.on('end', () => {
      console.log(JSON.parse(data))
    })
  },
)

req.end()

import os
import requests

response = requests.get(
    "https://api.getsillage.com/api/v2/watchlists/company/128/entities",
    params={"page": 1, "page_size": 25},
    headers={"Authorization": f"Bearer {os.environ['SILLAGE_API_KEY']}"},
    timeout=30,
)
response.raise_for_status()
result = response.json()

Example response

{
  "data": [
    {
      "id": 901,
      "name": "OpenAI",
      "linkedin_handle": "openai",
      "linkedin_url": "https://www.linkedin.com/company/openai"
    }
  ],
  "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.