Search Taxonomies

get

https://api.lightcast.io/profiles/taxonomies/{facet}

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

Path Params

facet

string

enum

required

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.

autocomplete

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 skills).
false - Performs more extensive search using both name(s) and, if available, description (description currently only available for NOC search).

limit

integer

1 to 10000

Defaults to 10

Set number of search results to return.

area_version

string

enum

Defaults to us_area_2024_4

Specify Area taxonomy version to use.

Allowed:

soc_version

string

enum

Defaults to soc_2021

Specify SOC taxonomy version to use.

Allowed:

title_version

string

enum

Defaults to emsi

Specify Job Title taxonomy version to use.

Allowed:

cip_standard_version

string

enum

Defaults to 2020.0.0

Specify CIP standard taxonomy version to use.

Allowed:

cip_version

string

enum

Defaults to cip2010

Specify CIP taxonomy version to use.

Allowed:

company_version

string

enum

Defaults to emsi_company

Specify company taxonomy version to use.

Allowed:

onet_version

string

enum

Defaults to onet_2019

Specify ONET taxonomy version to use.

Allowed:

naics_version

string

enum

Defaults to naics_std_2022

Specify NAICS taxonomy version to use.

Allowed:

new_taxonomy_versions

boolean

enum

Defaults to false

Use new taxonomy versions.

Allowed:

area_us_version

string

enum

Defaults to 1.0.3

Specify US Area taxonomy version to use.

Allowed:

soc_lightcast_version

string

enum

Defaults to 2018.2021.0

Specify SOC Lightcast taxonomy version to use.

Allowed:

onet_standard_version

string

enum

Defaults to 2019.0.0

Specify ONET Standard taxonomy version to use.

Allowed:

lot_version

string

enum

Defaults to 7

Specify LOT taxonomy version to use.

Allowed:

Responses

200OK

400bad request

404requested resource not found