Skip to main content
POST
/
people
/
by-id
/
bulk
Bulk enrich people by ID
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

X-API-Key
string
header
required

Body

application/json
Required array length: 1 - 50 elements
linkedin_url
string
Example:

"https://www.linkedin.com/in/janedoe"

linkedin_id
string

LinkedIn vanity URL identifier.

Example:

"janedoe"

linkedin_num_id
integer

LinkedIn numeric member ID.

Example:

123456789

linkedin_urn
string

Stable LinkedIn URN.

Example:

"ACoAAAxxxxxxxx"

Response

One row per lookup, in input order. found rows carry the resolved person; queued rows carry the enrichment request context.

status
enum<string>

found when resolved from cache, queued when an async enrichment was started.

Available options:
found,
queued
person
object

The resolved person. Present when status is found.

enrichment
object

Enrichment request context. Present when status is queued.