Get all saved searches
Returns your saved searches across all product types.
What you need
At least one saved search shared with the API. Either create one with Create saved search, or create a search in the Specter app and share it from the saved-searches index via the three-dot menu (⋯) and “Share to API”. Global searches curated by Specter are always reachable.
Behaviour
- Returns searches across every product type:
company,people,investors,talent,stratintel(Investor Interest Signals),funding_rounds,acquisitionandipo. - Each carries a
product_type, aquery_id,full_count/new_count, andis_global, which istruefor searches curated by Specter. - Searches shared only within your team or organization are not returned.
- Use a search’s
idwith the matching product’s results endpoint to fetch results.
What you do next
- Query a search’s results. Take a search’s
idand call the matching product’s results endpoint: Get company saved search results, Get people saved search results, Get investor saved search results, Get talent signal saved search results, or Get investor-interest saved search results. - Remove one. Delete a search you no longer need with Delete search.
Authorizations
Response
API searches
The search id for the search, this should be used to query for results for the search.
42366
Name of the search
"New Fund (Past CC) - 360D"
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
249568
The type of product the search relates to.
company, investors, people, talent "talent"
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.
7
The number of new companies that have appeared in this search in the most recent month.
0