Skip to main content
Use lists and saved searches to group Companies, People or Talent Signals so they can be queried via the API.
Currently any saved search or list shared with the team will also be managed by
the API, though this will be removed in the near future.

​
Access & visibility

A search / list is available to the API if any of the following is true:
  • It was created by the API (lists only).
  • It is shared with the API via the UI toggle.
  • It is shared globally by Specter.

​
Sharing to API

  1. Within the platform, go to My Specter → Searches / Lists.
  2. Navigate to the saved search you wish to use via the API.
  3. Click the options menu […] and toggle Share with API.
  4. The saved search can now be queried and managed by the API. Toggle off at any time to remove API access.

​
Saved Searches

  • You cannot create saved searches via the API (currently).
  • You can query and use saved searches that are shared with the API or shared globally by Specter.

​
Lists

A list is available to the API if it was created by the API, shared with the API, or shared globally by Specter.

​
Create a list via the API

  • You can create lists using the POST endpoints for each product type: Companies, People, and Talent Signals. (These will be automatically shared with the API)
  • Ownership: When a list is created via the API, it is owned by the first team admin in your organization.
⌘I