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>",
  "linkedin_num_id": 123,
  "linkedin_urn": 123
}
'

{
  "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
  },
  "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,
  "linkedin_num_id": "123456",
  "linkedin_urn": "ACABCDEefghijklmnopqurfABCDefghijklnmop",
  "current_position_title": "Senior Research Scientist",
  "current_position_company_name": "Google AI",
  "current_position_company_website": "ai.google.com",
  "last_updated": "2025-01-01 14:40:56"
}

Enrichment

Get/Enrich people

What it does

Searches our people dataset and returns the most current professional profile for an individual matching the identifier(s) in your request—including career history, skills, and social presence.

Why you’d use it

Enrich people records from a known identifier for diligence, outreach, or CRM/warehouse syncs.

Key behaviours

Response: Returns a single person object when a match is found.

Currently queries for linkedin_num_id and linkedin_urn will not be enriched if they do not exist. This feature will be released at a future date.

This endpoint uses up 1 credit per person returned. If the endpoint returns 10 people then 10 credits are consumed.

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>",
  "linkedin_num_id": 123,
  "linkedin_urn": 123
}
'

{
  "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
  },
  "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,
  "linkedin_num_id": "123456",
  "linkedin_urn": "ACABCDEefghijklmnopqurfABCDefghijklnmop",
  "current_position_title": "Senior Research Scientist",
  "current_position_company_name": "Google AI",
  "current_position_company_website": "ai.google.com",
  "last_updated": "2025-01-01 14:40:56"
}

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

linkedin_num_id

number

The LinkedIn numeric ID for the person being requested, this is the member ID which is found in many datasets.

linkedin_urn

number

The LinkedIn URN for the person being requested, this is a non-changing unique reference which is found in many datasets.

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

Experience · object

required

Companies that the person has worked for.

Show child attributes

experience.company_name

string

required

The name of the company or organization

Example:

"Google AI"

experience.company_id

string | null

required

Unique identifier for the company in the system

Example:

"5e3a7f2b0aa7a3270a55f2a8"

experience.domain

string | null

required

The company's website domain

Example:

"ai.google.com"

experience.linkedin_url

string | null

required

LinkedIn URL for the company

Example:

"linkedin.com/company/google"

experience.description

string | null

required

Details about the role, responsibilities, and achievements

Example:

"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."

experience.company_size

string | null

required

The size category of the company

Example:

"10001+"

experience.industries

required

Industries the company operates in

Example:

[
  "Information Technology",
  "Software",
  "Artificial Intelligence",
  "Internet Services"
]

experience.title

string

required

Job title or position held

Example:

"Senior Research Scientist"

experience.departments

required

Departments or teams the person worked in

Example:

["Senior Leadership", "Engineering"]

experience.start_date

string | null

required

Start date of the position

Example:

"2020-03-01"

experience.end_date

string | null

required

End date of the position (null if current)

Example:

null

experience.location

string | null

required

Location where the work was performed

Example:

"Mountain View, California, United States, United States"

experience.is_current

boolean

required

Whether this is the person's current position

Example:

true

experience.founded_year

number | null

required

The year the company was founded

Example:

1998

experience.job_order

number

required

Sequential order of this job in the person's career (higher numbers for more recent positions)

Example:

3

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

Education · object

required

Educational background for the person

Show child attributes

education.name

string | null

required

The name of the educational institution

Example:

"Stanford University"

education.linkedin_url

string | null

required

LinkedIn URL for the educational institution

Example:

"linkedin.com/school/stanford-university"

education.field_of_study

string | null

required

The academic field or major area of study

Example:

"Computer Science"

education.degree_title

string | null

required

The type of degree or qualification obtained

Example:

"Ph.D."

education.description

string | null

required

Additional details about the educational experience, research focus, or achievements

Example:

"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."

education.start_date

string | null

required

The start date of the educational program

Example:

"2008-01-01"

education.end_date

string | null

required

The end date or graduation date of the educational program

Example:

"2013-01-01"

education.location

string | null

required

The location of the educational institution

Example:

"Stanford, California, United States, United States"

languages

Language · object[]

required

Languages that the person speaks

Show child attributes

languages.name

string | null

required

The name of the language

Example:

"Mandarin Chinese"

languages.proficiency_level

string | null

required

The level of proficiency in the language

Example:

"Limited Working Proficiency"

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

linkedin_num_id

number

The numeric ID for the LinkedIn account.

Example:

"123456"

linkedin_urn

string

The URN from LinkedIn for the account.

Example:

"ACABCDEefghijklmnopqurfABCDefghijklnmop"

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"

last_updated

string<date>

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

Example:

"2025-01-01 14:40:56"

Get/Enrich companies Get company info by ID

⌘I

API Documentation

Entities

Enrichment

Companies

Companies Lists

Company Searches

People

People Lists

People Searches

Talent

Talent Searches

Investor Interest

Investor Interest Searches

Searches

Get/Enrich people

Authorizations

Body

Response