Endpoint Examples

/totals

Get summary metrics on all profiles matching the filters.

POST /totals

Query Parameters

NameTypeDescription
title_versionenum

Specify Job Title taxonomy version to use.
This parameter is optional.

Default: emsi
Must be one of: emsi

company_versionenum

Specify company taxonomy version to use.
This parameter is optional.

Default: emsi_company
Must be one of: emsi_company

naics_versionenum

Specify NAICS taxonomy version to use.
This parameter is optional.

Default: naics_std_2017

Must be one of: naics_std_2017, naics_std_2022

cip_versionenum

Specify CIP taxonomy version to use.
This parameter is optional.

Default: cip2020
Must be one of: cip2010, cip2020

cip_standard_versionenumSpecify CIP standard taxonomy version to use.
This parameter is optional.
Default: 2020.0.0
Must be one of: 2010.0.1, 2020.0.0
new_taxonomy_versionsenumUse new taxonomy versions.
This parameter is optional.
Must be one of: true, false
lot_versionenumSpecify LOT taxonomy version to use.
This parameter is optional.
Default: 7
Must be one of: 7, 6

Request Body

{
  "filter": {
    "last_updated": {
      "start": "2020"
    },
    "company_name": [
      "Intel"
    ],
    "skills_name": {
      "include": [
        "C++ (Programming Language)"
      ],
      "exclude": [
        "R (Programming Language)"
      ]
    }
  },
  "metrics": [
    "profiles",
    "unique_schools"
  ]
}

Code Examples

curl --request POST \
  --url https://api.lightcast.io/ca-profiles/totals \
  --header 'Authorization: Bearer <ACCESS_TOKEN>' \
  --header 'Content-Type: application/json' \
  --data '{ "filter": { "last_updated": { "start": "2020" }, "company_name": [ "Intel" ], "skills_name": { "include": [ "C++ (Programming Language)" ], "exclude": [ "R (Programming Language)" ] } }, "metrics": [ "profiles", "unique_schools" ] }'

Response Examples

{
  "data": {
    "totals": {
      "profiles": 8448,
      "unique_schools": 2117
    }
  }
}
//Your request wasn't valid (bad parameter names or values).

{
  "errors": [
    {
      "status": 400,
      "title": "Malformed Request",
      "detail": "Expected array"
    }
  ]
}