Get people saved search results

curl --request GET \
  --url https://app.tryspecter.com/api/v1/searches/people/{searchId}/results \
  --header 'X-API-Key: <api-key>'

import requests

url = "https://app.tryspecter.com/api/v1/searches/people/{searchId}/results"

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}/results', 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}/results",
  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}/results"

	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))

}

require 'uri'
require 'net/http'

url = URI("https://app.tryspecter.com/api/v1/searches/people/{searchId}/results")

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

[
  {
    "person_id": "per_34f8a8ad1f7497b83e821345",
    "last_updated": "2026-07-13 17:37:30",
    "talent_signal_ids": [
      "58323b85-153b-4d3d-8c0c-62dbf41198dc"
    ],
    "investor_signal_ids": [
      "0340bac8-bcee-46a2-94bf-cf77e0c34253"
    ],
    "profile_picture_url": "https://peopledb-public.s3.eu-west-2.amazonaws.com/assets/profile-pictures/per_34f8a8ad1f7497b83e821345.jpg",
    "first_name": "Cosmin",
    "last_name": "Urdea",
    "full_name": "Cosmin Urdea",
    "linkedin_url": "https://www.linkedin.com/in/cosmin-urdea-0848973",
    "linkedin_num_id": 11147428,
    "linkedin_urn": "ACoAAEULqT0BasKeraebkQhLfmIwxpxTlNThQjE",
    "twitter_url": "https://x.com/moissinac",
    "github_url": "https://github.com/sarahchen9776",
    "about": "IT Software Consultant / Contractor 20+ years of experience in software development - Systems and Applications Architecture - Product Design / Management - Coach and mentorship Experience in various industries, but mostly in electronic payments. After a full carrier as a full stack developer and, later on, architect, I have decided to put my experience to use from a different perspective as Product Owner/Manager and it has been already 3 years and I am enjoying very much this new role.",
    "tagline": "Software Consultant / Contractor",
    "location": "Bucharest, București, Romania, Europe",
    "region": "Europe",
    "highlights": [
      "major_tech_experience",
      "prior_vc_backed_experience",
      "strong_technical_background",
      "vc_backed_experience"
    ],
    "level_of_seniority": "Senior Level",
    "years_of_experience": 21,
    "education_level": "",
    "experience": [
      {
        "company_name": "valantic (vormals mm1)",
        "linkedin_url": "https://www.linkedin.com/company/mm1",
        "title": "Senior Consultant Fintech & Digital Payment",
        "departments": [
          "Finance"
        ],
        "start_date": "2025-04-01",
        "is_current": true,
        "job_order": 13,
        "company_id": "6744b47c776432406530a72b",
        "domain": "mm1.com",
        "description": "As an Implementation Engineer at valantic, I play a pivotal role in the technical execution of Stripe integration projects, ensuring precision, efficiency, and robust infrastructure in every implementation. Leveraging deep technical expertise and payments industry experience, I design and deploy custom payment solutions that enhance operational efficiency and customer satisfaction.",
        "company_size": "51-200",
        "industry": [
          "Financial Services",
          "Financial Technology"
        ],
        "tech_verticals": [
          [
            "Blockchain, Crypto & Web3",
            "Crypto Exchanges and Trading Infrastructure"
          ]
        ],
        "end_date": "2025-03-01",
        "location": "Stuttgart, Baden-Wurttemberg, Germany, Europe",
        "founded_year": 1997
      }
    ],
    "current_position_title": "Senior Consultant Fintech & Digital Payment",
    "current_position_company_name": "valantic (vormals mm1)",
    "current_position_company_website": "mm1.com",
    "past_position_title": "Product Owner (Contracted)",
    "past_position_company_name": "Riverty",
    "past_position_company_website": "riverty.com",
    "current_tenure": 15,
    "average_tenure": 22,
    "education": [
      {
        "name": "Stanford University",
        "linkedin_url": "https://www.linkedin.com/school/stanford-university",
        "field_of_study": "Computer Science (AI track) and Statistics",
        "degree_title": "Bachelor of Science - BS",
        "description": "<p class=\"show-more-less-text__text--less\">\n        Krieger School of Arts and Sciences<br>Bloomberg School of Public Health<br>(joint degree program)\n<!---->      </p>",
        "start_date": "2024-01-01",
        "end_date": "2028-01-01",
        "location": "Stanford, California, United States, North America"
      }
    ],
    "languages": [
      {
        "name": "English",
        "proficiency_level": "Native Or Bilingual Proficiency"
      },
      {
        "name": "Mandarin Chinese",
        "proficiency_level": "Limited Working Proficiency"
      }
    ],
    "skills": [
      "API Development",
      "Agentic AI",
      "Agentic Orchestration",
      "Algorithmic Trading",
      "Algorithms",
      "Apache Spark",
      "C#",
      "C++",
      "CORS",
      "Communication"
    ],
    "linkedin_followers": 904,
    "linkedin_connections": 500
  }
]

{
  "errorCode": "BAD_SEARCH_ID_TYPE",
  "message": "The search id needs to be a number."
}

{
  "errorCode": "API_KEY_MISSING",
  "message": "No API Key was presented on the header X-API-KEY"
}

{
  "errorCode": "OUT_OF_CREDITS",
  "message": "<string>"
}

{
  "errorCode": "NOT_PERMITTED",
  "message": "You do not have permission to access this resource."
}

{
  "errorCode": "<string>",
  "message": "<string>"
}

{
  "errorCode": "<string>",
  "message": "<string>"
}

People Saved Searches

Get people saved search results

Returns the people matching a saved people search.

Costs 1 credit per result returned.

What you need

A people saved-search ID shared with the API; get one from Get all saved searches, or check counts first with Get people saved search.

Behaviour

Page through with page and limit.
Must be a people search, otherwise 400 with NOT_SUPPORTED_PRODUCT.
Returns 404 if the search doesn’t exist or isn’t accessible.

What you do next

Open the profile. Pass a person_id to Get person by ID.
Get an email. Fetch a verified address with Get person email.

GET

searches

people

{searchId}

results

Get people saved search results

curl --request GET \
  --url https://app.tryspecter.com/api/v1/searches/people/{searchId}/results \
  --header 'X-API-Key: <api-key>'

import requests

url = "https://app.tryspecter.com/api/v1/searches/people/{searchId}/results"

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}/results', 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}/results",
  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}/results"

	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))

}

require 'uri'
require 'net/http'

url = URI("https://app.tryspecter.com/api/v1/searches/people/{searchId}/results")

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

[
  {
    "person_id": "per_34f8a8ad1f7497b83e821345",
    "last_updated": "2026-07-13 17:37:30",
    "talent_signal_ids": [
      "58323b85-153b-4d3d-8c0c-62dbf41198dc"
    ],
    "investor_signal_ids": [
      "0340bac8-bcee-46a2-94bf-cf77e0c34253"
    ],
    "profile_picture_url": "https://peopledb-public.s3.eu-west-2.amazonaws.com/assets/profile-pictures/per_34f8a8ad1f7497b83e821345.jpg",
    "first_name": "Cosmin",
    "last_name": "Urdea",
    "full_name": "Cosmin Urdea",
    "linkedin_url": "https://www.linkedin.com/in/cosmin-urdea-0848973",
    "linkedin_num_id": 11147428,
    "linkedin_urn": "ACoAAEULqT0BasKeraebkQhLfmIwxpxTlNThQjE",
    "twitter_url": "https://x.com/moissinac",
    "github_url": "https://github.com/sarahchen9776",
    "about": "IT Software Consultant / Contractor 20+ years of experience in software development - Systems and Applications Architecture - Product Design / Management - Coach and mentorship Experience in various industries, but mostly in electronic payments. After a full carrier as a full stack developer and, later on, architect, I have decided to put my experience to use from a different perspective as Product Owner/Manager and it has been already 3 years and I am enjoying very much this new role.",
    "tagline": "Software Consultant / Contractor",
    "location": "Bucharest, București, Romania, Europe",
    "region": "Europe",
    "highlights": [
      "major_tech_experience",
      "prior_vc_backed_experience",
      "strong_technical_background",
      "vc_backed_experience"
    ],
    "level_of_seniority": "Senior Level",
    "years_of_experience": 21,
    "education_level": "",
    "experience": [
      {
        "company_name": "valantic (vormals mm1)",
        "linkedin_url": "https://www.linkedin.com/company/mm1",
        "title": "Senior Consultant Fintech & Digital Payment",
        "departments": [
          "Finance"
        ],
        "start_date": "2025-04-01",
        "is_current": true,
        "job_order": 13,
        "company_id": "6744b47c776432406530a72b",
        "domain": "mm1.com",
        "description": "As an Implementation Engineer at valantic, I play a pivotal role in the technical execution of Stripe integration projects, ensuring precision, efficiency, and robust infrastructure in every implementation. Leveraging deep technical expertise and payments industry experience, I design and deploy custom payment solutions that enhance operational efficiency and customer satisfaction.",
        "company_size": "51-200",
        "industry": [
          "Financial Services",
          "Financial Technology"
        ],
        "tech_verticals": [
          [
            "Blockchain, Crypto & Web3",
            "Crypto Exchanges and Trading Infrastructure"
          ]
        ],
        "end_date": "2025-03-01",
        "location": "Stuttgart, Baden-Wurttemberg, Germany, Europe",
        "founded_year": 1997
      }
    ],
    "current_position_title": "Senior Consultant Fintech & Digital Payment",
    "current_position_company_name": "valantic (vormals mm1)",
    "current_position_company_website": "mm1.com",
    "past_position_title": "Product Owner (Contracted)",
    "past_position_company_name": "Riverty",
    "past_position_company_website": "riverty.com",
    "current_tenure": 15,
    "average_tenure": 22,
    "education": [
      {
        "name": "Stanford University",
        "linkedin_url": "https://www.linkedin.com/school/stanford-university",
        "field_of_study": "Computer Science (AI track) and Statistics",
        "degree_title": "Bachelor of Science - BS",
        "description": "<p class=\"show-more-less-text__text--less\">\n        Krieger School of Arts and Sciences<br>Bloomberg School of Public Health<br>(joint degree program)\n<!---->      </p>",
        "start_date": "2024-01-01",
        "end_date": "2028-01-01",
        "location": "Stanford, California, United States, North America"
      }
    ],
    "languages": [
      {
        "name": "English",
        "proficiency_level": "Native Or Bilingual Proficiency"
      },
      {
        "name": "Mandarin Chinese",
        "proficiency_level": "Limited Working Proficiency"
      }
    ],
    "skills": [
      "API Development",
      "Agentic AI",
      "Agentic Orchestration",
      "Algorithmic Trading",
      "Algorithms",
      "Apache Spark",
      "C#",
      "C++",
      "CORS",
      "Communication"
    ],
    "linkedin_followers": 904,
    "linkedin_connections": 500
  }
]

{
  "errorCode": "BAD_SEARCH_ID_TYPE",
  "message": "The search id needs to be a number."
}

{
  "errorCode": "API_KEY_MISSING",
  "message": "No API Key was presented on the header X-API-KEY"
}

{
  "errorCode": "OUT_OF_CREDITS",
  "message": "<string>"
}

{
  "errorCode": "NOT_PERMITTED",
  "message": "You do not have permission to access this resource."
}

{
  "errorCode": "<string>",
  "message": "<string>"
}

{
  "errorCode": "<string>",
  "message": "<string>"
}

Authorizations

X-API-Key

string

header

required

Path Parameters

searchId

integer

required

The ID of the saved search being requested.

Query Parameters

limit

number

The number of results to return, default is 50.

page

number

The page number of results to return, base 0, default is 0.

Response

The list of people that were found for the query

person_id

string

required

The Specter person ID for this person, can be used in people endpoints.

Example:

"per_34f8a8ad1f7497b83e821345"

last_updated

string

required

A date for when the person was last updated in Specter. Uses the format YYYY-MM-DD HH:MM:SS.

Example:

"2026-07-13 17:37:30"

talent_signal_ids

string[] | null

Talent signal IDs for this person, can be used in talent endpoints

Example:

["58323b85-153b-4d3d-8c0c-62dbf41198dc"]

investor_signal_ids

string[] | null

Investor signal IDs for this person, will be usable in investor endpoints when available.

profile_picture_url

string | null

A url for a profile picture if there is one.

Example:

"https://peopledb-public.s3.eu-west-2.amazonaws.com/assets/profile-pictures/per_34f8a8ad1f7497b83e821345.jpg"

first_name

string

First name

Example:

"Cosmin"

last_name

string

Last Name

Example:

"Urdea"

full_name

string

Full name

Example:

"Cosmin Urdea"

linkedin_url

string

URL for LinkedIn account.

Example:

"https://www.linkedin.com/in/cosmin-urdea-0848973"

linkedin_num_id

number

The numeric ID for the LinkedIn account.

Example:

11147428

linkedin_urn

string

The URN from LinkedIn for the account.

Example:

"ACoAAEULqT0BasKeraebkQhLfmIwxpxTlNThQjE"

twitter_url

string | null

URL for Twitter account.

Example:

"https://x.com/moissinac"

github_url

string | null

URL for Github account.

Example:

"https://github.com/sarahchen9776"

about

string | null

A description of the person.

Example:

"IT Software Consultant / Contractor 20+ years of experience in software development - Systems and Applications Architecture - Product Design / Management - Coach and mentorship Experience in various industries, but mostly in electronic payments. After a full carrier as a full stack developer and, later on, architect, I have decided to put my experience to use from a different perspective as Product Owner/Manager and it has been already 3 years and I am enjoying very much this new role."

tagline

string | null

A shorter tagline for the person.

Example:

"Software Consultant / Contractor"

location

string | null

Where the person is located.

Example:

"Bucharest, București, Romania, Europe"

region

string | null

Main region where the person is located.

Example:

"Europe"

highlights

string[]

Type of highlight, the full list will be added shortly.

Example:

[
  "major_tech_experience",
  "prior_vc_backed_experience",
  "strong_technical_background",
  "vc_backed_experience"
]

level_of_seniority

string | null

Top level of seniority the person has achieved.

Example:

"Senior Level"

years_of_experience

number | null

Years of experience the person has worked for.

Example:

21

education_level

string | null

Top level of education that the person has.

Example:

""

experience

Experience · object[]

Companies that the person has worked for.

Show child attributes

current_position_title

string | null

Title of the person's current position

Example:

"Senior Consultant Fintech & Digital Payment"

current_position_company_name

string | null

Name of the company where the person currently works.

Example:

"valantic (vormals mm1)"

current_position_company_website

string | null

Website for the company where the person currently works.

Example:

"mm1.com"

past_position_title

string | null

Title of the person's last position

Example:

"Product Owner (Contracted)"

past_position_company_name

string | null

Name of the company where the person last left.

Example:

"Riverty"

past_position_company_website

string | null

Website for the company where the person last left.

Example:

"riverty.com"

current_tenure

number | null

Length of time the person has been in their current job.

Example:

15

average_tenure

number | null

Average length of time in a position.

Example:

22

education

Education · object[]

Educational background for the person

Show child attributes

languages

Language · object[] | null

Languages that the person speaks

Show child attributes

Example:

[
  {
    "name": "English",
    "proficiency_level": "Native Or Bilingual Proficiency"
  },
  {
    "name": "Mandarin Chinese",
    "proficiency_level": "Limited Working Proficiency"
  }
]

skills

string[]

List of skills that the person has.

Example:

[
  "API Development",
  "Agentic AI",
  "Agentic Orchestration",
  "Algorithmic Trading",
  "Algorithms",
  "Apache Spark",
  "C#",
  "C++",
  "CORS",
  "Communication"
]

linkedin_followers

number

Number of followers the person has on LinkedIn.

Example:

904

linkedin_connections

number

Number of connections the person has on LinkedIn.

Example:

500

Enrich

Search

Companies

People

Investors

Transactions

Signals

Lists

Saved Searches

Network

Account

Get people saved search results

What you need

Behaviour

What you do next

Authorizations

Path Parameters

Query Parameters

Response