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 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. Update company list to add or remove members; Delete 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 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).
  • Both the collection and the per-list response carry is_global, which is true for lists curated by Specter, and shared_with, the Specter user IDs the list is shared with ([] when it is not shared). Resolve an ID to a person with Get organization members.
  • Deleting a list is irreversible.