Skip to main content
With our Saved Searches API, you can fetch your team’s saved searches and execute them live to retrieve their current results.

​
Search types

Each saved search targets a single entity type, described by its searchType:
  • COMPANY — returns companies
  • LEGAL_ENTITY — returns legal entities
  • EMPLOYEES — returns contacts
The searchType determines the shape of the items returned by the results endpoint.

​
Live execution

The results endpoint runs the saved search’s stored filters against the latest data every time it is called — results are never cached.

​
Identifiers

Saved search IDs (savedSearchId) are obfuscated. You obtain them from the overview endpoint.

​
Authorization

The Public API token is team-scoped. Every request only operates on saved searches that belong to your team; requesting one from another team returns 404.