Skip to main content
Lists are curated sets of companies, people, or investors you want to track and pull on demand. Build a list once — in the Specter app or via the API — then read its members’ full, current records through a single call, and maintain it programmatically.

​
What you can do

  • Create and name a list, add or remove members, and delete it.
  • Pull the full current records for everything on a list in one call.
  • Keep lists in sync with your own systems (CRM, warehouse) without touching the app.

​
Sharing a list with the API

A list is reachable from the API when it is created by the API, explicitly shared to the API (the “Share to API” toggle on the list in the app), or a global list curated by Specter. A list shared only within your team is not reachable, and lists that aren’t shared won’t appear in the API.

​
Endpoints

Each list type — companies, people, investors — exposes the same six operations.

​
Company lists

​
People lists

​
Investor lists

​
How to use the API

Get started analysing a set of companies:
  1. Create or pick a list — build it in the app, or create one with Create a new company list. List names must be unique.
  2. Make sure it’s shared — created via the API, or “Share to API” on in the app.
  3. Find it — Get all company lists to get its listId and size.
  4. Pull the records — Get company list results returns the full current profile for every company on the list, paginated.
  5. Maintain it — Modify a company list to add or remove members; Delete a company list when done.
Chain into the rest of the API. List results (and the “list info” member IDs) give you company, person, or investor IDs — follow them to Get company by ID, Get person info by ID, or Get investor by ID for deeper detail.

​
Good to know

  • A list must be created by the API, explicitly shared to the API via “Share to API”, or a global list curated by Specter to be reachable. Lists shared only within your team are not accessible from the API.
  • List names must be unique (this rule applies to lists, not saved searches).
  • Results are paginated; the record shape matches the underlying product object (company / person / investor).
  • Deleting a list is irreversible.