Skip to main content
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>'
[
  {
    "person_id": "per_7f8d9e2a1b3c4d5e6f7g8h9i0",
    "talent_signal_ids": [
      "02d32673-f1ab-40a1-93c5-a3a36a10d342"
    ],
    "investor_signal_ids": [
      "0340bac8-bcee-46a2-94bf-cf77e0c34253"
    ],
    "profile_picture_url": "https://peopledb-public.s3.eu-west-2.amazonaws.com/assets/profile-pictures/per_7f8d9e2a1b3c4d5e6f7g8h9i0.jpg",
    "first_name": "Sarah",
    "last_name": "Chen",
    "full_name": "Sarah Chen",
    "linkedin_url": "https://www.linkedin.com/in/sarahchen9776",
    "twitter_url": "https://twitter.com/sarahchen9776",
    "github_url": "https://github.com/sarahchen9776",
    "about": "AI/ML researcher and entrepreneur with a focus on computer vision applications. Previously led ML teams at Google and founded an AI startup.",
    "tagline": "AI Researcher | Ex-Google | Founder of VisionAI (Acquired by NVIDIA)",
    "location": "San Francisco, California, United States, North America",
    "region": "North America",
    "highlights": [
      "prior_exit",
      "prior_vc_backed_experience",
      "prior_vc_backed_founder",
      "serial_founder"
    ],
    "level_of_seniority": "Executive Level",
    "years_of_experience": 12,
    "education_level": "Ph.D.",
    "experience": {
      "company_name": "Google AI",
      "company_id": "5e3a7f2b0aa7a3270a55f2a8",
      "domain": "ai.google.com",
      "linkedin_url": "linkedin.com/company/google",
      "description": "Lead research initiatives in computer vision and deep learning. Developed novel architectures for image recognition that improved accuracy by 15%. Mentor junior researchers and collaborate with product teams to integrate ML models into Google products.",
      "company_size": "10001+",
      "industries": [
        "Information Technology",
        "Software",
        "Artificial Intelligence",
        "Internet Services"
      ],
      "title": "Senior Research Scientist",
      "departments": [
        "Senior Leadership",
        "Engineering"
      ],
      "start_date": "2020-03-01",
      "end_date": null,
      "location": "Mountain View, California, United States, United States",
      "is_current": true,
      "founded_year": 1998,
      "job_order": 3
    },
    "current_position_title": "Senior Research Scientist",
    "current_position_company_name": "Google AI",
    "current_position_company_website": "ai.google.com",
    "past_position_title": "Founder & CEO",
    "past_position_company_name": "VisionAI",
    "past_position_company_website": "visionai.com",
    "current_tenure": 3,
    "average_tenure": 18,
    "education": {
      "name": "Stanford University",
      "linkedin_url": "linkedin.com/school/stanford-university",
      "field_of_study": "Computer Science",
      "degree_title": "Ph.D.",
      "description": "Dissertation focused on computer vision and deep learning algorithms. Published 15 papers in top-tier ML conferences including NIPS and ICML. Teaching assistant for Advanced Machine Learning course.",
      "start_date": "2008-01-01",
      "end_date": "2013-01-01",
      "location": "Stanford, California, United States, United States"
    },
    "languages": [
      {
        "name": "English",
        "proficiency_level": "Native Or Bilingual Proficiency"
      },
      {
        "name": "Mandarin Chinese",
        "proficiency_level": "Limited Working Proficiency"
      }
    ],
    "skills": [
      "Machine Learning",
      "Computer Vision",
      "Deep Learning",
      "Python",
      "TensorFlow",
      "PyTorch"
    ],
    "linkedin_followers": 8756,
    "linkedin_connections": 3421
  }
]

Authorizations

X-API-Key
string
header
required

Path Parameters

searchId
string
required

The search ID that is being queried for.

Query Parameters

limit
number

The number of results to return, default is 25.

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 company, can be used in people endpoints.

Example:

"per_7f8d9e2a1b3c4d5e6f7g8h9i0"

talent_signal_ids
string[]
required

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

investor_signal_ids
string[]
required

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

profile_picture_url
string | null
required

A url for a profile picture if there is one.

Example:

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

first_name
string
required

First name

Example:

"Sarah"

last_name
string
required

Last Name

Example:

"Chen"

full_name
string
required

Full name

Example:

"Sarah Chen"

linkedin_url
string
required

URL for LinkedIn account.

Example:

"https://www.linkedin.com/in/sarahchen9776"

twitter_url
string | null
required

URL for Twitter account.

Example:

"https://twitter.com/sarahchen9776"

github_url
string | null
required

URL for Github account.

Example:

"https://github.com/sarahchen9776"

about
string | null
required

A description of the person.

Example:

"AI/ML researcher and entrepreneur with a focus on computer vision applications. Previously led ML teams at Google and founded an AI startup."

tagline
string | null
required

A shorter tagline for the person.

Example:

"AI Researcher | Ex-Google | Founder of VisionAI (Acquired by NVIDIA)"

location
string | null
required

Where the person is located.

Example:

"San Francisco, California, United States, North America"

region
string | null
required

Main region where the person is located.

Example:

"North America"

highlights
string[]
required

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

Example:
[
"prior_exit",
"prior_vc_backed_experience",
"prior_vc_backed_founder",
"serial_founder"
]
level_of_seniority
string | null
required

Top level of seniority the person has achieved.

Example:

"Executive Level"

years_of_experience
number | null
required

Years of experience the person has worked for.

Example:

12

education_level
string | null
required

Top level of education that the person has.

Example:

"Ph.D."

experience
object
required

Companies that the person has worked for.

past_position_title
string | null
required

Title of the person's last position

Example:

"Founder & CEO"

past_position_company_name
string | null
required

Name of the company where the person last left.

Example:

"VisionAI"

past_position_company_website
string | null
required

Website for the company where the person last left.

Example:

"visionai.com"

current_tenure
number | null
required

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

Example:

3

average_tenure
number | null
required

Average length of time in a position.

Example:

18

education
object
required

Educational background for the person

languages
Language · object[]
required

Languages that the person speaks

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

List of skills that the person has.

Example:
[
"Machine Learning",
"Computer Vision",
"Deep Learning",
"Python",
"TensorFlow",
"PyTorch"
]
linkedin_followers
number
required

Number of followers the person has on LinkedIn.

Example:

8756

linkedin_connections
number
required

Number of connections the person has on LinkedIn.

Example:

3421

current_position_title
string | null

Title of the person's current position

Example:

"Senior Research Scientist"

current_position_company_name
string | null

Name of the company where the person currently works.

Example:

"Google AI"

current_position_company_website
string | null

Website for the company where the person currently works.

Example:

"ai.google.com"

I