curl --request GET \
--url https://app.tryspecter.com/api/v1/searches/investor-interest/{searchId} \
--header 'X-API-Key: <api-key>'import requests
url = "https://app.tryspecter.com/api/v1/searches/investor-interest/{searchId}"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://app.tryspecter.com/api/v1/searches/investor-interest/{searchId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.tryspecter.com/api/v1/searches/investor-interest/{searchId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://app.tryspecter.com/api/v1/searches/investor-interest/{searchId}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://app.tryspecter.com/api/v1/searches/investor-interest/{searchId}")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.tryspecter.com/api/v1/searches/investor-interest/{searchId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"id": 40254,
"name": "Nordic Stealth Founders Raising Rounds",
"query_id": 226132,
"product_type": "stratintel",
"owner_id": "<string>",
"full_count": 21,
"is_global": false
}{
"errorCode": "NOT_SUPPORTED_PRODUCT",
"message": "The product \"people\" is not supported by this operation. Only \"companies\" are supported."
}{
"errorCode": "API_KEY_MISSING",
"message": "No API Key was presented on the header X-API-KEY"
}{
"errorCode": "NOT_PERMITTED",
"message": "API key present, but you are not permitted"
}{
"errorCode": "NOT_FOUND",
"message": "Not Found"
}{
"errorCode": "VALIDATION_ERROR",
"message": "Field required (body.name)"
}{
"errorCode": "RATE_LIMITED",
"message": "You have been rate-limited"
}{
"errorCode": "clerk_unavailable",
"message": "Key verification is temporarily unavailable"
}Get investor-interest saved search
Returns count-level details for a saved investor-interest search: its name, query ID, and the number of interest signals matched.
Free. This call does not consume credits.
What you need
An investor-interest saved-search ID shared with the API; get one from Get all saved searches.
Behaviour
- Returns metadata and counts only (no per-signal records); fetch the signals with Get investor-interest saved search results.
- The saved search must be shared with the API (via “Share to API”) or be a global search curated by Specter.
- Must be an investor-interest search, otherwise
400withNOT_SUPPORTED_PRODUCT. - Returns
404if the search doesn’t exist orsearchIdis not a number.
What you do next
- Pull the records. Fetch matches with Get investor-interest saved search results.
curl --request GET \
--url https://app.tryspecter.com/api/v1/searches/investor-interest/{searchId} \
--header 'X-API-Key: <api-key>'import requests
url = "https://app.tryspecter.com/api/v1/searches/investor-interest/{searchId}"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://app.tryspecter.com/api/v1/searches/investor-interest/{searchId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.tryspecter.com/api/v1/searches/investor-interest/{searchId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://app.tryspecter.com/api/v1/searches/investor-interest/{searchId}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://app.tryspecter.com/api/v1/searches/investor-interest/{searchId}")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.tryspecter.com/api/v1/searches/investor-interest/{searchId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"id": 40254,
"name": "Nordic Stealth Founders Raising Rounds",
"query_id": 226132,
"product_type": "stratintel",
"owner_id": "<string>",
"full_count": 21,
"is_global": false
}{
"errorCode": "NOT_SUPPORTED_PRODUCT",
"message": "The product \"people\" is not supported by this operation. Only \"companies\" are supported."
}{
"errorCode": "API_KEY_MISSING",
"message": "No API Key was presented on the header X-API-KEY"
}{
"errorCode": "NOT_PERMITTED",
"message": "API key present, but you are not permitted"
}{
"errorCode": "NOT_FOUND",
"message": "Not Found"
}{
"errorCode": "VALIDATION_ERROR",
"message": "Field required (body.name)"
}{
"errorCode": "RATE_LIMITED",
"message": "You have been rate-limited"
}{
"errorCode": "clerk_unavailable",
"message": "Key verification is temporarily unavailable"
}Response
The details of the query for a given search id.
Saved-search metadata common to every product.
Returned as-is by the people, talent, investor-interest, funding-rounds, acquisitions and IPOs detail endpoints, and subclassed by the products that publish their own descriptions or counts.
The query id that this search is related to. It opens the search in the app as the last segment of the feed of the search's product_type: for example https://app.tryspecter.com/companies/10 for a company search, /people/10 for people, /people/talent/10 for talent signals, /investors/10 for investors, /investors/interest/10 for investor interest signals, and /transactions/funding-rounds/10, /transactions/acquisitions/10 or /transactions/ipos/10 for the transaction products.
226132
Was this page helpful?