Enrich people

Look up and enrich a person by a known LinkedIn identifier - URL, vanity ID, numeric ID, or URN. Returns the most current professional profile - career history, education, skills, languages, and social presence.

Costs 1 credit per person returned.

What you need

One LinkedIn identifier for the person: their profile URL, vanity ID, numeric ID, or URN. Supply exactly one per request. You don’t need a Specter person ID; if you already have one, call Get person info by ID directly.

Behaviour

• Returns a single person object when matched.
• If the person isn’t in the dataset yet, returns 202 and queues them for enrichment; usually available within 24 hours.
• linkedin_num_id and linkedin_urn lookups only match existing records; they don’t trigger enrichment yet.

What you do next

• Reach out. The profile doesn’t include a contactable address; get one with Get person’s email.

POST /people

Enrich people

cURL

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/patrickcollison"
}
'

import requests

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

payload = { "linkedin_url": "https://www.linkedin.com/in/patrickcollison" }
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/patrickcollison'})
};

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/patrickcollison'
  ]),
  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/patrickcollison\"\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/patrickcollison\"\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/patrickcollison\"\n}"

response = http.request(request)
puts response.read_body

200

Example

{
  "person_id": "per_34f8a8ad1f7497b83e821345",
  "last_updated": "2026-07-13 17:37:30",
  "talent_signal_ids": [
    "58323b85-153b-4d3d-8c0c-62dbf41198dc"
  ],
  "investor_signal_ids": [
    "0340bac8-bcee-46a2-94bf-cf77e0c34253"
  ],
  "profile_picture_url": "https://peopledb-public.s3.eu-west-2.amazonaws.com/assets/profile-pictures/per_34f8a8ad1f7497b83e821345.jpg",
  "first_name": "Cosmin",
  "last_name": "Urdea",
  "full_name": "Cosmin Urdea",
  "linkedin_url": "https://www.linkedin.com/in/cosmin-urdea-0848973",
  "linkedin_num_id": 11147428,
  "linkedin_urn": "ACoAAEULqT0BasKeraebkQhLfmIwxpxTlNThQjE",
  "twitter_url": "https://x.com/moissinac",
  "github_url": "https://github.com/sarahchen9776",
  "about": "IT Software Consultant / Contractor 20+ years of experience in software development - Systems and Applications Architecture - Product Design / Management - Coach and mentorship Experience in various industries, but mostly in electronic payments. After a full carrier as a full stack developer and, later on, architect, I have decided to put my experience to use from a different perspective as Product Owner/Manager and it has been already 3 years and I am enjoying very much this new role.",
  "tagline": "Software Consultant / Contractor",
  "location": "Bucharest, București, Romania, Europe",
  "region": "Europe",
  "highlights": [
    "major_tech_experience",
    "prior_vc_backed_experience",
    "strong_technical_background",
    "vc_backed_experience"
  ],
  "level_of_seniority": "Senior Level",
  "years_of_experience": 21,
  "education_level": "",
  "experience": [
    {
      "company_name": "valantic (vormals mm1)",
      "linkedin_url": "https://www.linkedin.com/company/mm1",
      "title": "Senior Consultant Fintech & Digital Payment",
      "departments": [
        "Finance"
      ],
      "start_date": "2025-04-01",
      "is_current": true,
      "job_order": 13,
      "company_id": "6744b47c776432406530a72b",
      "domain": "mm1.com",
      "description": "As an Implementation Engineer at valantic, I play a pivotal role in the technical execution of Stripe integration projects, ensuring precision, efficiency, and robust infrastructure in every implementation. Leveraging deep technical expertise and payments industry experience, I design and deploy custom payment solutions that enhance operational efficiency and customer satisfaction.",
      "company_size": "51-200",
      "industry": [
        "Financial Services",
        "Financial Technology"
      ],
      "tech_verticals": [
        [
          "Blockchain, Crypto & Web3",
          "Crypto Exchanges and Trading Infrastructure"
        ]
      ],
      "end_date": "2025-03-01",
      "location": "Stuttgart, Baden-Wurttemberg, Germany, Europe",
      "founded_year": 1997
    }
  ],
  "current_position_title": "Senior Consultant Fintech & Digital Payment",
  "current_position_company_name": "valantic (vormals mm1)",
  "current_position_company_website": "mm1.com",
  "past_position_title": "Product Owner (Contracted)",
  "past_position_company_name": "Riverty",
  "past_position_company_website": "riverty.com",
  "current_tenure": 15,
  "average_tenure": 22,
  "education": [
    {
      "name": "Stanford University",
      "linkedin_url": "https://www.linkedin.com/school/stanford-university",
      "field_of_study": "Computer Science (AI track) and Statistics",
      "degree_title": "Bachelor of Science - BS",
      "description": "<p class=\"show-more-less-text__text--less\">\n        Krieger School of Arts and Sciences<br>Bloomberg School of Public Health<br>(joint degree program)\n<!---->      </p>",
      "start_date": "2024-01-01",
      "end_date": "2028-01-01",
      "location": "Stanford, California, United States, North America"
    }
  ],
  "languages": [
    {
      "name": "English",
      "proficiency_level": "Native Or Bilingual Proficiency"
    },
    {
      "name": "Mandarin Chinese",
      "proficiency_level": "Limited Working Proficiency"
    }
  ],
  "skills": [
    "API Development",
    "Agentic AI",
    "Agentic Orchestration",
    "Algorithmic Trading",
    "Algorithms",
    "Apache Spark",
    "C#",
    "C++",
    "CORS",
    "Communication"
  ],
  "linkedin_followers": 904,
  "linkedin_connections": 500
}

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

200

application/json

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

last_updated · string · required

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

Example:

"2026-07-13 17:37:30"

talent_signal_ids · string[] | null

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

Example:

["58323b85-153b-4d3d-8c0c-62dbf41198dc"]

investor_signal_ids · string[] | null

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

profile_picture_url · string | null

A url for a profile picture if there is one.

Example:

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

first_name · string

First name

Example:

"Cosmin"

last_name · string

Last Name

Example:

"Urdea"

full_name · string

Full name

Example:

"Cosmin Urdea"

linkedin_url · string

URL for LinkedIn account.

Example:

"https://www.linkedin.com/in/cosmin-urdea-0848973"

linkedin_num_id · number

The numeric ID for the LinkedIn account.

Example:

11147428

linkedin_urn · string

The URN from LinkedIn for the account.

Example:

"ACoAAEULqT0BasKeraebkQhLfmIwxpxTlNThQjE"

twitter_url · string | null

URL for Twitter account.

Example:

"https://x.com/moissinac"

github_url · string | null

URL for Github account.

Example:

"https://github.com/sarahchen9776"

about · string | null

A description of the person.

Example:

"IT Software Consultant / Contractor 20+ years of experience in software development - Systems and Applications Architecture - Product Design / Management - Coach and mentorship Experience in various industries, but mostly in electronic payments. After a full carrier as a full stack developer and, later on, architect, I have decided to put my experience to use from a different perspective as Product Owner/Manager and it has been already 3 years and I am enjoying very much this new role."

tagline · string | null

A shorter tagline for the person.

Example:

"Software Consultant / Contractor"

location · string | null

Where the person is located.

Example:

"Bucharest, București, Romania, Europe"

region · string | null

Main region where the person is located.

Example:

"Europe"

highlights · string[]

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

Example:

[
  "major_tech_experience",
  "prior_vc_backed_experience",
  "strong_technical_background",
  "vc_backed_experience"
]

level_of_seniority · string | null

Top level of seniority the person has achieved.

Example:

"Senior Level"

years_of_experience · number | null

Years of experience the person has worked for.

Example:

21

education_level · string | null

Top level of education that the person has.

Example:

""

experience · Experience · object[]

Companies that the person has worked for.

Show child attributes

current_position_title · string | null

Title of the person's current position

Example:

"Senior Consultant Fintech & Digital Payment"

current_position_company_name · string | null

Name of the company where the person currently works.

Example:

"valantic (vormals mm1)"

current_position_company_website · string | null

Website for the company where the person currently works.

Example:

"mm1.com"

past_position_title · string | null

Title of the person's last position

Example:

"Product Owner (Contracted)"

past_position_company_name · string | null

Name of the company where the person last left.

Example:

"Riverty"

past_position_company_website · string | null

Website for the company where the person last left.

Example:

"riverty.com"

current_tenure · number | null

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

Example:

15

average_tenure · number | null

Average length of time in a position.

Example:

22

education · Education · object[]

Educational background for the person

Show child attributes

languages · Language · object[] | null

Languages that the person speaks

Show child attributes

Example:

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

skills · string[]

List of skills that the person has.

Example:

[
  "API Development",
  "Agentic AI",
  "Agentic Orchestration",
  "Algorithmic Trading",
  "Algorithms",
  "Apache Spark",
  "C#",
  "C++",
  "CORS",
  "Communication"
]

linkedin_followers · number

Number of followers the person has on LinkedIn.

Example:

904

linkedin_connections · number

Number of connections the person has on LinkedIn.

Example:

500