v1

latestOpenAPI 3.1.02026-07-26103879.6 KB

Look up people

Look up a single person using their identifiers (professional network URL/ID, or full name combined with a company identifier). Returns the best matching person.

post/people/lookup

Request body

person_namestring

Full name of the person to look up.

person_professional_network_urlstring

Professional network profile URL of the person.

person_professional_network_idinteger

Professional network profile ID of the person.

company_professional_network_urlstring

Professional network URL of the company the person works for. Used to disambiguate when looking up by name.

company_professional_network_idinteger

Professional network ID of the company the person works for. Used to disambiguate when looking up by name.

company_domainstring

Domain of the company the person works for. Used to disambiguate when looking up by name.

Example request

{
  "person_name": "Enzo Romera",
  "person_professional_network_url": "https://www.linkedin.com/in/enzo-romera",
  "person_professional_network_id": 530992355,
  "company_professional_network_url": "https://www.linkedin.com/company/anthropic",
  "company_professional_network_id": 1883877,
  "company_domain": "anthropic.com"
}

Response

OK

Example response

{
  "people": [
    {
      "id": "746e4816-19c8-54d8-b558-65a5a52cc85c",
      "full_name": "Enzo Romera",
      "first_name": "Enzo",
      "last_name": "Romera",
      "location": {
        "country": "United States",
        "country_code": "US",
        "city": "San Francisco",
        "region": "California"
      },
      "social_profiles": {
        "professional_network": {
          "id": 1234,
          "url": "https://www.linkedin.com/in/john-doe",
          "handle": "john-doe",
          "connection_count": 500
        }
      },
      "educations": [
        {
          "school_name": "Stanford University",
          "degree": "Bachelor of Science in Computer Science",
          "start_at": "2015-09-01T00:00:00Z",
          "end_at": "2019-06-01T00:00:00Z"
        }
      ],
      "languages": [
        {
          "language": "French",
          "proficiency": "NATIVE_OR_BILINGUAL"
        }
      ],
      "skills": [
        "JavaScript",
        "Project Management",
        "Python"
      ],
      "employment": {
        "current": {
          "title": "Senior Software Engineer",
          "seniority": "Senior",
          "job_functions": [
            {
              "function": "Not Employed",
              "sub_function": "Freelancer"
            }
          ],
          "description": "Leading the backend team and designing microservices architecture.",
          "company": {
            "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
            "name": "Anthropic",
            "domain": "anthropic.com",
            "description": "AI safety and research company",
            "year_founded": 2021,
            "headcount": 2610,
            "headcount_range": "1001-5000",
            "company_type": "Privately Held",
            "specialties": [
              "Data Enrichment",
              "B2B Data"
            ],
            "locations": {
              "headquarters": {
                "line1": "548 Market St",
                "line2": "San Francisco, CA 94105, US",
                "city": "San Francisco",
                "region": "California",
                "country": "United States",
                "country_code": "US"
              },
              "offices": [
                {
                  "line1": "111 8th Ave",
                  "line2": "New York, NY 10011, US"
                }
              ]
            },
            "industry": {
              "main_industry": "Software Development"
            },
            "social_profiles": {
              "professional_network": {
                "id": 1234,
                "url": "https://www.linkedin.com/company/anthropic",
                "handle": "anthropic",
                "connection_count": 125000
              }
            }
          },
          "is_current": true,
          "start_at": "2022-03-15T00:00:00Z",
          "end_at": "2024-06-30T00:00:00Z"
        },
        "all": [
          {
            "title": "Senior Software Engineer",
            "seniority": "Senior",
            "job_functions": [
              {
                "function": "Not Employed",
                "sub_function": "Freelancer"
              }
            ],
            "description": "Leading the backend team and designing microservices architecture.",
            "company": {
              "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
              "name": "Anthropic",
              "domain": "anthropic.com",
              "description": "AI safety and research company",
              "year_founded": 2021,
              "headcount": 2610,
              "headcount_range": "1001-5000",
              "company_type": "Privately Held",
              "specialties": [
                "Data Enrichment",
                "B2B Data"
              ],
              "locations": {
                "headquarters": {
                  "line1": "548 Market St",
                  "line2": "San Francisco, CA 94105, US",
                  "city": "San Francisco",
                  "region": "California",
                  "country": "United States",
                  "country_code": "US"
                },
                "offices": [
                  {
                    "line1": "111 8th Ave",
                    "line2": "New York, NY 10011, US"
                  }
                ]
              },
              "industry": {
                "main_industry": "Software Development"
              },
              "social_profiles": {
                "professional_network": {
                  "id": 1234,
                  "url": "https://www.linkedin.com/company/anthropic",
                  "handle": "anthropic",
                  "connection_count": 125000
                }
              }
            },
            "is_current": true,
            "start_at": "2022-03-15T00:00:00Z",
            "end_at": "2024-06-30T00:00:00Z"
          }
        ]
      }
    }
  ],
  "metadata": {
    "credits": 0.25
  }
}