Skip to main content
POST
/
people
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": "https://www.linkedin.com/in/kilianthalhammer"
}
'
import requests

url = "https://app.tryspecter.com/api/v1/people"

payload = { "linkedin_url": "https://www.linkedin.com/in/kilianthalhammer" }
headers = {
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)
const options = {
  method: 'POST',
  headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({linkedin_url: 'https://www.linkedin.com/in/kilianthalhammer'})
};

fetch('https://app.tryspecter.com/api/v1/people', 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/people",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'linkedin_url' => 'https://www.linkedin.com/in/kilianthalhammer'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "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"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.tryspecter.com/api/v1/people"

	payload := strings.NewReader("{\n  \"linkedin_url\": \"https://www.linkedin.com/in/kilianthalhammer\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-API-Key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.post("https://app.tryspecter.com/api/v1/people")
  .header("X-API-Key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"linkedin_url\": \"https://www.linkedin.com/in/kilianthalhammer\"\n}")
  .asString();
require 'uri'
require 'net/http'

url = URI("https://app.tryspecter.com/api/v1/people")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"linkedin_url\": \"https://www.linkedin.com/in/kilianthalhammer\"\n}"

response = http.request(request)
puts response.read_body
{
  "person_id": "per_7f8d9e2a1b3c4d5e6f7g8h9i0",
  "talent_signal_ids": [
    "02d32673-f1ab-40a1-93c5-a3a36a10d342"
  ],
  "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",
  "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",
      "linkedin_url": "linkedin.com/company/google",
      "industries": [
        "Information Technology",
        "Software",
        "Artificial Intelligence",
        "Internet Services"
      ],
      "title": "Senior Research Scientist",
      "departments": [
        "Senior Leadership",
        "Engineering"
      ],
      "start_date": "2020-03-01",
      "is_current": true,
      "job_order": 3,
      "company_id": "5e3a7f2b0aa7a3270a55f2a8",
      "domain": "ai.google.com",
      "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+",
      "industry": [
        "Financial Services",
        "Financial Technology"
      ],
      "tech_verticals": [
        [
          "Blockchain, Crypto & Web3",
          "Crypto Exchanges and Trading Infrastructure"
        ]
      ],
      "end_date": null,
      "location": "Mountain View, California, United States, United States",
      "founded_year": 1998
    }
  ],
  "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,
  "investor_signal_ids": [
    "0340bac8-bcee-46a2-94bf-cf77e0c34253"
  ],
  "linkedin_num_id": 9365023,
  "linkedin_urn": "ACABCDEefghijklmnopqurfABCDefghijklnmop",
  "github_url": "https://github.com/sarahchen9776",
  "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

Supply exactly one identifier. Providing more than one returns a validation error.

​
linkedin_url
string

The person's LinkedIn profile URL. Accepts http/https, with or without www.

​
linkedin_id
string

The person's LinkedIn vanity ID — the slug at the end of their profile URL (e.g. john-doe-123abc in linkedin.com/in/john-doe-123abc).

​
linkedin_num_id
integer

The person's LinkedIn numeric member ID.

​
linkedin_urn
string

The person's LinkedIn URN — a stable, non-changing reference 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 person, can be used in people endpoints.

Example:

"per_7f8d9e2a1b3c4d5e6f7g8h9i0"

​
talent_signal_ids
string[] | null
required

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

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

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

​
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

​
languages
Language · object[] | null
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

​
investor_signal_ids
string[] | null

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

​
linkedin_num_id
number

The numeric ID for the LinkedIn account.

Example:

9365023

​
linkedin_urn
string

The URN from LinkedIn for the account.

Example:

"ACABCDEefghijklmnopqurfABCDefghijklnmop"

​
github_url
string | null

URL for Github account.

Example:

"https://github.com/sarahchen9776"

​
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

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"