A Workforce Data API to Power Your Dream Apps

Great data is the unlock for engineers to build apps faster, non-technical users to build apps with AI and for AI systems themselves to get smarter.

Our API unlocks fast, accurate job change and work history data on 80M verified white collar professionals for all of these use cases.

Non-Technical Quick Start with AI

Our AI ready docs and prompts can be pasted directly into Cursor, Bolt.new, ChatGPT or Claude to get working code however you need it. Reach out to our team to get your API account set up.

How to Start

Quick Start With AI

AI-Ready Documentation

      [DESCRIBE YOUR APP HERE]
      Live Data People API Documentation:



To integrate the Live Data Technologies API, here is documentation and authentication sample. 

The People API provides direct access to Live Data's Warehouse and full person objects.

Key Endpoints:
1. Find specific person (/find) - Use email, name + company, LinkedIn URL
2. Search for people (/search) - Query by attributes like job history, titles, companies
3. Download people data (/search/download) - Get results as CSV

Authentication:
All calls require a Bearer token. Obtain via OAuth2:
curl -X POST 'https://gotlivedata.io/api/identity/v1/session' \
-H 'Content-Type: application/json' \
-d '{
  "grantType": "clientCredentials",
  "clientId": "YOUR_CLIENT_ID",
  "clientSecret": "YOUR_CLIENT_SECRET"
}'

Required Headers:
- Authorization: Bearer 
- Content-Type: application/json
- Accept: application/json

Core Data Fields:
- jobs.company.name: Company name
- jobs.title: Job title
- jobs.function: Job function (e.g., "Engineering")
- jobs.company_tenure: The person’s tenure at this company, across contiguous jobs, in months
- jobs.company: Dictionary of company-specific information related to the job
- jobs.location: Location of this job
- jobs.ended_at: Date this job ended
- jobs.started_at: Date this job started
- jobs.title: Title of the person at this job
- jobs.level: Level derived from title
- jobs.function: Function derived from title
- education: Array of the person’s education history
- location: Location of this person
- jobs: An array of all jobs the person has held
- linkedin: The LinkedIn ID for this person
- name: Name of the person
- country: Name of the country this person lives in
    
Firmographic Fields
- company.ultimate_parent: The ultimate parent company for this company
- company.name: Name of the company
- company.id: Unique Live Data ID for this company
- company.location: Primary general locality of the business
- company.linkedin: LinkedIn slug for the company
- company.ticker: Public stock ticker for the company, if applicable
- company.type: Company type (public, private, govt, non-profit, etc.)
- company.address: Primary street address
- company.country: Primary country the business operates in
- company.domain: Primary domain for the company
- company.employee_count: Total employee count
- company.industry: Primary industry
- company.sic_codes: SIC codes

Education Fields
- education.ended_at: Ended at date, no more precise than M/D
- education.started_at: Started at date, no more precise than M/D
- education.school: Name of the school
- education.field: Name of the field of study
- education.degree: Name of the degree the person achieved

Location Details Fields
- raw: The input location value from which other values were derived
- fips_code: The FIPS code for this location
- lon: The longitude for this location, generalized
- lat: The latitude for this location, generalized
- msa: The standard MSA name that this location belongs to, if any
- postal_code: The central/primary postal code associated with this location
- county: The county name for this location (US locations)
- locality: The normalized locality name for this location (City in the US)
- region_abbreviation: The standard abbreviation for the normalized region
- region: The normalized region name for this location (State in the US)
- country_code: The two-letter ISO country code for this location
- country: The normalized country name for this location

Ultimate Parent Fields
- ultimate_parent.ticker: Public stock ticker for the ultimate parent company, if applicable
- ultimate_parent.domain: Primary domain for the ultimate parent company
- ultimate_parent.linkedin: LinkedIn slug for the ultimate parent company
- ultimate_parent.name: Name of the ultimate parent company
- ultimate_parent.id: Unique Live Data ID for the ultimate parent company

Sample Query: Looking for current engineers at a specific company.

const engineersPayload = {
        filters: [{
            operator: "and",
            filters: [
                {
                    field: "jobs.company.linkedin",
                    type: "must",
                    match_type: "exact",
                    string_values: [companyId]
                },
                {
                    field: "jobs.function",
                    type: "must",
                    match_type: "exact",
                    string_values: ["Engineering"]
                },
                {
                    field: "jobs.ended_at",
                    type: "must_not",
                    match_type: "exists"
                },
                {
                    field: "jobs.started_at",
                    type: "must",
                    match_type: "exists"
                }
            ]
        }],
        size: 0,
        aggs: []
    };

Sample API Queries

Find Engineers

Track engineers at a specific company

{
  "filters": [{
    "operator": "and",
    "filters": [
      {
        "field": "jobs.company.id",
        "type": "must",
        "match_type": "exact",
        "string_values": ["YOUR_COMPANY_LINKEDIN_ID"]
      },
      {
        "field": "jobs.function",
        "type": "must",
        "match_type": "exact",
        "string_values": ["Engineering"]
      }
    ]
  }],
  "size": 100
}

Track Job Changes

Monitor departures and new hires at the companies you care about

{
  "filters": [{
    "operator": "and",
    "filters": [
      {
        "field": "jobs.started_at",
        "type": "must",
        "match_type": "fuzzy",
        "date_from": "2024-01-01"
      },
      {
        "field": "jobs.company.name",
        "type": "must",
        "match_type": "fuzzy",
        "string_values": ["TARGET_COMPANY"]
      }
    ]
  }],
  "size": 100
}

Find Specific Titles

Spot hiring trends by role Ex: AI Engineers

{
  "filters": [{
    "operator": "and",
    "filters": [{
      "field": "jobs.title",
      "type": "must",
      "match_type": "fuzzy",
      "string_values": [
        "AI Engineer",
        "Member of Technical Staff",
        "ML Engineer"
      ]
    }]
  }],
  "size": 100
}