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.
- Filter the counts with
new(companies first seen in this search),newGrowthHighlights(new growth changes), ornewFundingHighlights(new funding changes). - 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.
Query Parameters
Tells the results to have only new data since the last delivery.
Note: Applies only to company searches
Tells the results to have only companies with new growth highlights.
Tells the results to have only companies with new funding highlights.
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"
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
The number of companies that have new funding highlights in this search.
133
The number of companies that have new growth highlights in this search.
17988