Skip to main content
POST
/
people
Get/Enrich people
curl --request POST \
  --url https://app.tryspecter.com/api/v1/people \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '{
  "linkedin_url": "<string>",
  "linkedin_id": "<string>"
}'
{
  "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

Body

application/json

A request body must be supplied in JSON format with only one of the properties specified. If more than one property is specified then a validation error will be returned.

​
linkedin_url
string

The LinkedIn profile URL of the person being requested. This can be in the form with http:// or https:// as well as with or without www..

​
linkedin_id
string

The LinkedIn id for the person, this is the unique identifier that appears at the end of their LinkedIn profile URL (e.g. for https://www.linkedin.com/in/john-doe-123abc, the id would be 'john-doe-123abc')

Response

A successful response containing the detailed professional profile of the requested person.

​
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