Search Taxonomies

get

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

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

Path Params

facet

string

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 assumed to be a prefix.

autocomplete

boolean

Defaults to true

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

limit

integer

1 to 10000

Defaults to 10

How many search results to return.

new_taxonomy_versions

boolean

enum

Defaults to false

Use new taxonomy versions.

Allowed:

lot_version

string

enum

Defaults to 7

Specify LOT taxonomy version to use.

Allowed:

naics_version

string

enum

Defaults to naics_std_2022

Specify NAICS taxonomy version to use.

Allowed:

area_version

string

enum

Defaults to lf_area_2025_1

Specify area taxonomy version to use.

Allowed:

area_laa_version

string

enum

Defaults to 2

Specify LAA area taxonomy version to use.

Allowed:

Responses

Language

Credentials

OAuth2

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200ok

400Your request wasn't valid (bad parameter names or values).

404The facet you requested wasn't found.

500The service is not healthy (e.g. can't connect to datastore).