Status Page
API Reference

/taxonomies/{facet}

get
https://api.lightcast.io/company-postings/taxonomies/

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

Path Params
enum
required

Which taxonomy to search for ID/name suggestions.

Query Params
string

A query string of whole or partial keywords to search for. Only when autocomplete is true is q is assumed to be a prefix. If q is omitted, the response will list results sorted by id of length limit.

boolean
Defaults to true

Autocomplete search terms. Only used in combination with q.

  • 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).

integer
1 to 10000
Defaults to 10

How many search results to return.

string
enum
Defaults to soc_2021

Specify SOC taxonomy version to use.

Allowed:
string
enum
Defaults to onet_2019

Specify ONET taxonomy version to use.

Allowed:
string
enum
Defaults to emsi

Specify Job Title taxonomy version to use.

Allowed:
string
enum
Defaults to emsi_company

Specify company taxonomy version to use.

Allowed:
string
enum
Defaults to naics_std_2022

Specify NAICS taxonomy version to use.

Allowed:
boolean
enum
Defaults to false

Use new taxonomy versions.

Allowed:
string
enum
Defaults to us_area_2024_4

Specify area taxonomy version to use.

Allowed:
string
enum
Defaults to 2.0.0

Specify area taxonomy version to use.

Allowed:
string
enum
Defaults to 2018.2021.0

Specify SOC Lightcast taxonomy version to use.

Allowed:
string
enum
Defaults to 2019.0.0

Specify ONET Standard taxonomy version to use.

Allowed:
Responses

Updated 3 months ago

Language
Credentials
OAuth2
Missing 1 required scope
Response 
Click Try It! to start a request and see the response here! Or choose an example:
application/json
Updated 3 months ago