curl --request GET \
--url https://app.tryspecter.com/api/v1/searches/people/{searchId} \
--header 'X-API-Key: <api-key>'import requests
url = "https://app.tryspecter.com/api/v1/searches/people/{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/people/{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/people/{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/people/{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/people/{searchId}")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.tryspecter.com/api/v1/searches/people/{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 people saved search
Returns count-level details for a saved people search: its name, query ID, and the number of people matched.
Free. This call does not consume credits.
What you need
A people saved-search ID shared with the API; get one from Get all saved searches.
Behaviour
- Returns metadata and counts only (no per-person records); fetch the people with Get people 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 a people search, otherwise
400withNOT_SUPPORTED_PRODUCT. - Returns
404if the search doesn’t exist.
What you do next
- Pull the records. Fetch matches with Get people saved search results.
curl --request GET \
--url https://app.tryspecter.com/api/v1/searches/people/{searchId} \
--header 'X-API-Key: <api-key>'import requests
url = "https://app.tryspecter.com/api/v1/searches/people/{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/people/{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/people/{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/people/{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/people/{searchId}")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.tryspecter.com/api/v1/searches/people/{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"
}Authorizations
Path Parameters
The ID of the saved search being requested.
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 search id for the search, this should be used to query for results for the search.
40254
Name of the search
"Nordic Stealth Founders Raising Rounds"
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
The type of product the search relates to.
"stratintel"
Id of the user who owns the saved search. Only a search owned by an admin of your organization can be deleted through the API.
The total number of items that are returned by this search.
21
This flags searches recommended by Specter for all users
false
Was this page helpful?