Individual Lookup

Pull one person's work history and education from their LinkedIn profile. Synchronous, returns the data directly.

POST /work_education

Costs 0.3 credit per row. Returns the data directly in the response, no list and no polling.

Pass a LinkedIn profile URL. The response contains an array of past and current roles in data.work_experience, and an array of schools in data.education_history.

Headers

Name	Value
Content-Type	application/json

Body

Name	Type	Description
api_key	string	Your API Key.
person_linkedin_url	string	LinkedIn profile URL of the person to look up.

Example

Input

{
  "api_key": "your_api_key",
  "person_linkedin_url": "https://www.linkedin.com/in/jane-doe-example/"
}

Output

{
  "status": "success",
  "data": {
    "person_linkedin_url": "https://www.linkedin.com/in/jane-doe-example/",
    "work_experience": [
      {
        "company_name": "Acme Corp",
        "current_title": "VP of Sales",
        "location": "Austin, Texas",
        "start_date": "2022-03",
        "end_date": null,
        "is_current": true,
        "company_linkedin_url": "https://www.linkedin.com/company/acme-corp/",
        "description": null,
        "employment_type": "Full-time"
      },
      {
        "company_name": "Prior Co",
        "current_title": "Director of Sales",
        "location": "Austin, Texas",
        "start_date": "2018",
        "end_date": "2022",
        "is_current": false,
        "company_linkedin_url": null,
        "description": null,
        "employment_type": null
      }
    ],
    "education_history": [
      {
        "school_name": "University of Texas at Austin",
        "degree": "Bachelor's Degree, Business",
        "field_of_study": null,
        "start_date": "2010",
        "end_date": "2014",
        "school_linkedin_url": null
      }
    ]
  },
  "credits_used": 0.3,
  "credits_remaining": 4823,
  "success": true
}

Not found

{
  "status": "not_found",
  "data": {
    "person_linkedin_url": "https://www.linkedin.com/in/jane-doe-example/",
    "work_experience": [],
    "education_history": []
  },
  "credits_used": 0,
  "credits_remaining": 4823,
  "success": true
}

Error

{
  "status": "error",
  "error": {
    "code": "validation_error",
    "message": "person_linkedin_url: Field required"
  },
  "success": false
}

Response

Field	Type	Description
person_linkedin_url	string	The profile that was looked up.
work_experience	array	One entry per role: company_name, current_title, location, start_date, end_date, is_current, company_linkedin_url, description, employment_type.
education_history	array	One entry per school: school_name, degree, field_of_study, start_date, end_date, school_linkedin_url.

Dates come back as YYYY-MM, or YYYY when only the year is known. Anything the provider sent that has no field of its own is kept under extra on that entry.

The record is under data. See Response Format for the fields every endpoint returns.

To pull history for every contact in a list in one call instead, use List Lookup.