Lists

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.