Get investor saved search details
What it does
Returns the results of a single saved investor search — name, query ID, and the total number of investors the search currently matches.
Why you’d use it
-
Confirm a saved search exists and is bound to the expected query before paginating its results via
/searches/investors/{search_id}/results. -
Show the matched-investor count in a UI or report without fetching the full result set.
Key behaviours
-
Path param:
searchIdis required and must be numeric. Non-numeric values return404 Not Found. -
The saved search must be an investor search. If the search exists but its
product_typeis notinvestors, the endpoint returns400 NOT_SUPPORTED_PRODUCT. -
full_countmay benullwhile the search’s total count is still being computed.
The saved search must be shared with the API, or shared globally by Specter, to be queried.
Documentation Index
Fetch the complete documentation index at: https://api.tryspecter.com/llms.txt
Use this file to discover all available pages before exploring further.
Authorizations
Path Parameters
The search ID that is being queried for.
Response
The details of an investor saved search.
The search id for the saved search, this should be used to query for results for the saved search.
163
Name of the saved search.
"US Climate-Tech Investors"
The query id that this saved search is related to, this can be used to query for the search in the address bar. , e.g. https://app.tryspecter.com/signals/investor/feed?queryId=10.
10
The product type the saved search applies to. Always investors for this endpoint — searches of a different product type return 400 NOT_SUPPORTED_PRODUCT.
investors "investors"
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 investors that are returned by this saved search.
248