curl --request POST \
--url https://app.tryspecter.com/api/v1/people/by-id/bulk \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
[
{
"linkedin_url": "https://www.linkedin.com/in/janedoe"
},
{
"linkedin_num_id": 123456789
}
]
'[
{
"person": {
"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,
"industry": [
"Financial Services",
"Financial Technology"
],
"tech_verticals": [
[
"Blockchain, Crypto & Web3",
"Crypto Exchanges and Trading Infrastructure"
]
]
},
"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": {
"message": "Enrichment in progress",
"context": {}
}
}
]Bulk enrich people by ID
Resolve up to 50 people in a single request. This is the bulk counterpart to POST /people — pass a JSON array of lookup objects (1–50), each identifying one person by LinkedIn URL, vanity ID, numeric ID, or URN.
Provide exactly one identifier per lookup object. The response preserves input order so you can map each result back to its lookup. Each result row carries a status: found (resolved from cache, with the person payload) or queued (an asynchronous enrichment was kicked off; poll later).
This endpoint uses 1 credit per found result. queued rows are not charged here — the eventual enrichment is billed by the async pipeline.
curl --request POST \
--url https://app.tryspecter.com/api/v1/people/by-id/bulk \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
[
{
"linkedin_url": "https://www.linkedin.com/in/janedoe"
},
{
"linkedin_num_id": 123456789
}
]
'[
{
"person": {
"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,
"industry": [
"Financial Services",
"Financial Technology"
],
"tech_verticals": [
[
"Blockchain, Crypto & Web3",
"Crypto Exchanges and Trading Infrastructure"
]
]
},
"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": {
"message": "Enrichment in progress",
"context": {}
}
}
]Authorizations
Body
Response
One row per lookup, in input order. found rows carry the resolved person; queued rows carry the enrichment request context.
found when resolved from cache, queued when an async enrichment was started.
found, queued The resolved person. Present when status is found.
Show child attributes
Show child attributes
Enrichment request context. Present when status is queued.
Show child attributes
Show child attributes