Get company saved search
Returns count-level details for a saved company search: total companies matched, newly added, and companies with highlights.
What you need
A company saved-search ID shared with the API; get one from Get all saved searches.
Behaviour
- Returns counts only (no per-company records); fetch the companies with Get company saved search results.
- The counts describe the whole search and take no query parameters. For the subset added since a moment you choose, read the results with
new_results_after. - The saved search must be shared with the API (via “Share to API”) or be a global search curated by Specter.
searchIdmust be a number, otherwise400; returns404if the search doesn’t exist, and400withNOT_SUPPORTED_PRODUCTif the search belongs to a non-company product.
What you do next
- Pull the companies. Fetch full records with Get company saved search results.
Authorizations
Path Parameters
The ID of the saved search being requested.
Response
The details of the query for a given search id.
The search id for the search, this should be used to query for results for the search.
41012
Name of the search
"skyboundclin"
The query id that this search is related to, this can be used to query for the search in the address bar.
https://app.tryspecter.com/signals/company/feed?queryId=10
152001
The type of product the search relates to.
company, investors, people, talent "company"
true when the saved search is a global search curated by Specter and available to all users. false for searches owned by your organization.
false
The total number of companies that are returned by this search.
408264
The number of new companies that have appeared in this search in the most recent month.
0