Skip to main content
GET
/
lists
/
talent
/
{listId}
/
results
Get talent list results
curl --request GET \
  --url https://app.tryspecter.com/api/v1/lists/talent/{listId}/results \
  --header 'X-API-Key: <api-key>'
[
  {
    "talent_signal_id": "02d32673-f1ab-40a1-93c5-a3a36a10d342",
    "person_id": "per_7f8d9e2a1b3c4d5e6f7g8h9i0",
    "signal_date": "2018-03-15",
    "signal_score": 9,
    "signal_type": "New Company",
    "signal_status": "Stealth",
    "out_of_stealth_advantage": 6,
    "announcement_delay_months": 3,
    "talent_last_signal": true,
    "new_position_title": "Founder & CEO",
    "new_position_company_id": "5e3a7f2b0aa7a3270a55f2b9",
    "new_position_company_name": "VisionAI",
    "new_position_company_website": "visionai.com",
    "new_position_company_tagline": "Computer vision AI platform for enterprise applications",
    "past_position_company_id": "5e3a7f2b0aa7a3270a55f2a8",
    "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
    },
    "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

​
listId
string<uuid>
required

The UUID of the list being requested

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 talent signals that were found for the query

​
talent_signal_id
string
required

Unique identifier for this talent signal

Example:

"02d32673-f1ab-40a1-93c5-a3a36a10d342"

​
person_id
string
required

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

Example:

"per_7f8d9e2a1b3c4d5e6f7g8h9i0"

​
signal_score
number
required

Confidence score for this talent signal (1-10 scale)

Example:

9

​
signal_type
string
required

Type of talent signal detected

Example:

"New Company"

​
signal_status
string
required

Current status of the talent signal

Example:

"Stealth"

​
out_of_stealth_advantage
number | null
required

Advantage in months of detecting talent before public announcement

Example:

6

​
announcement_delay_months
number
required

Number of months before the move was publicly announced

Example:

3

​
talent_last_signal
boolean
required

Whether this is the most recent signal for this person

Example:

true

​
new_position_title
string | null
required

Job title at the new position

Example:

"Founder & CEO"

​
new_position_company_id
string | null
required

Company ID for the new position

Example:

"5e3a7f2b0aa7a3270a55f2b9"

​
new_position_company_name
string | null
required

Company name for the new position

Example:

"VisionAI"

​
new_position_company_website
string | null
required

Website of the new position company

Example:

"visionai.com"

​
new_position_company_tagline
string | null
required

Tagline or description of the new position company

Example:

"Computer vision AI platform for enterprise applications"

​
past_position_company_id
string | null
required

Company ID for the previous position

Example:

"5e3a7f2b0aa7a3270a55f2a8"

​
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

​
signal_date
string

Date when the talent signal was detected

Example:

"2018-03-15"

⌘I