Status Page
API Reference

Endpoint Examples

/taxonomies

Search taxonomies using either whole keywords (relevance search) or partial keywords (autocomplete), or list taxonomy items.

GET /taxonomies

Get a list of current available taxonomy facets.

Code Examples

curl --request GET \
  --url https://api.lightcast.io/global-profiles/taxonomies \
  --header 'Authorization: Bearer <ACCESS_TOKEN>'

Response Examples

{
  "data": [
    "company",
    "gender",
    "onet",
    "schools",
    "skills",
    "title",
    "city"
  ]
}

GET /taxonomies/{facet}

Search taxonomies using either whole keywords (relevance search) or partial keywords (autocomplete).

Path Parameters

NameDescription
facet
enum

Which taxonomy to search for ID/name suggestions.
Example: title

Must be one of: company, city, gender, skills, title, schools, onet, lot_specialized_occupation, lot_career_area, lot_occupation, lot_occupation_group, laa_metro, laa_country, laa_admin_area_1, laa_admin_area_2, skill_categories, skills_subcategories, naics2, naics3, naics4, naics5, naics6

Query Parameters

NameDescription
q
string

A query string of whole or partial keywords to search for. Only when autocomplete is true is q assumed to be a prefix.

This parameter is optional.

Example: data sci

autocomplete
boolean		Autocomplete search terms.
  • true - Performs fast prefix-enabled search using only primary and, if available, alternate names (alternate names currently available for ONET and skills).
  • false - Performs more extensive search using both name(s) and, if available, description (description currently only available for SOC and ONET search).
This parameter is optional.

Default: true

limit
integer

How many search results to return.

This parameter is optional.
Minimum: 1

Maximum: 10000 Default: 10

new_taxonomy_versions
enum

Use new taxonomy versions.

This parameter is optional.
Must be one of: true, false

lot_version
enum		Specify LOT taxonomy version to use.
This parameter is optional.
Default: 7
Must be one of: 6, 7
naics_version
enum

Specify NAICS taxonomy version to use.

This parameter is optional.

Default: naics_std_2022

Must be one of: naics_std_2022, naics_std_2017

area_version
enum

Specify area taxonomy version to use.

This parameter is optional.

Default: lf_area_2025_1
Must be one of: lf_area_2023_2, lf_area_2025_1

area_laa_version
enum

Specify LAA area taxonomy version to use.

This parameter is optional.
Default: 2
Must be one of: 1, 2

Code Examples

curl --request GET \
  --url 'https://api.lightcast.io/global-profiles/taxonomies/{facet}' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>'

Response Examples

{
  "data": [
    {
      "id": "ET3B93055220D592C8",
      "name": "Data Scientists",
      "properties": {
        "profiles": 80049
      },
      "score": 119.149925
    },
    {
      "id": "ET66EFA7BC3A32BB32",
      "name": "Managers/Data Scientists",
      "properties": {
        "profiles": 19220
      },
      "score": 100.861015
    },
    {
      "id": "ET6F4C400F82935C3E",
      "name": "Data Science Managers",
      "properties": {
        "profiles": 8973
      },
      "score": 93.85294
    },
    {
      "id": "ET3B7D691B9A3FCB65",
      "name": "Data Science Interns",
      "properties": {
        "profiles": 6986
      },
      "score": 91.550095
    },
    {
      "id": "ETB15B6675998124CE",
      "name": "Lead Data Scientists",
      "properties": {
        "profiles": 5895
      },
      "score": 89.98795
    },
    {
      "id": "ET8428FBC2C9F2D438",
      "name": "Directors of Data Science",
      "properties": {
        "profiles": 4399
      },
      "score": 83.76882
    },
    {
      "id": "ETC81FBF8B48383129",
      "name": "Clinical Data Scientists",
      "properties": {
        "profiles": 2752
      },
      "score": 82.980286
    },
    {
      "id": "ET55CAD92A486D925B",
      "name": "Heads of Data Science",
      "properties": {
        "profiles": 3889
      },
      "score": 82.68104
    },
    {
      "id": "ET486D61EA8B4CBC36",
      "name": "Data Science Consultants",
      "properties": {
        "profiles": 2636
      },
      "score": 82.58415
    },
    {
      "id": "ET6B57FB37DA4AA8A8",
      "name": "Data Science Analysts",
      "properties": {
        "profiles": 2392
      },
      "score": 81.690704
    }
  ]
}

POST /taxonomies/{facet}/lookup

Lookup taxonomy items by ID.

Path Parameters

NameDescription
facet
enum

Which taxonomy to to look up IDs in.

Example: title
Must be one of: company, onet, schools, skills, title, city

Query Parameters

NameDescription
new_taxonomy_versions
enum

Use new taxonomy versions.
This parameter is optional.

Must be one of: true, false

lot_version
enum

Specify LOT taxonomy version to use.

This parameter is optional.

Default: 7
Must be one of: 6, 7

naics_version
enum

Specify NAICS taxonomy version to use.

This parameter is optional.
Default: naics_std_2022
Must be one of: naics_std_2022, naics_std_2017

area_version
enum

Specify area taxonomy version to use.

This parameter is optional.
Default: lf_area_2025_1

Must be one of: lf_area_2023_2, lf_area_2025_1

area_laa_version
enum

Specify LAA area taxonomy version to use.
This parameter is optional.
Default: 2

Must be one of: 1, 2

Request Body

{
  "ids": [
    "ET0004AFC23172193E"
  ]
}

Code Examples

curl --request POST \
  --url https://api.lightcast.io/global-profiles/taxonomies/{facet}/lookup \
  --header 'Authorization: Bearer <ACCESS_TOKEN>' \
  --header 'Content-Type: application/json' \
  --data '{ "ids": [ "ET0004AFC23172193E" ] }'

Response Examples

{
  "data": [
    {
      "id": "ET0004AFC23172193E",
      "name": "Industrial Security Managers",
      "properties": {
        "profiles": 419
      }
    }
  ]
}

Updated 11 days ago

Did this page help you?

Updated 11 days ago

Did this page help you?