LIlightcast
Taxonomies

GET /taxonomies/{facet}

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

Request

  • Base URL
    api.lightcast.io/jpa (relative, and the document’s source URL is not known)
  • URL
    api.lightcast.io/jpa/taxonomies/{facet}
  • Auth
    OAuth 2
    Client credentials
    Token URL: https://auth.emsicloud.com/connect/token scopes: postings:us

Path parameters

facet'city' | 'cip2' | 'cip4' | 'cip6' | 'company' | 'county' | 'edulevels' | 'employment_type' | 'fips' | 'lot_career_area' | 'lot_occupation_group' | 'lot_occupation' | 'lot_specialized_occupation' | 'msa' | 'msa_skill_cluster' | 'naics2' | 'naics3' | 'naics4' | 'naics5' | 'naics6' | 'national_skill_cluster' | 'onet' | 'remote_type' | 'skill_categories' | 'skill_subcategories' | 'skills' | 'soc2' | 'soc3' | 'soc4' | 'soc5' | 'state' | 'state_skill_cluster' | 'title' required

Which taxonomy to search for ID/name suggestions.

Query parameters

qstring

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.

autocompleteboolean

Autocomplete search terms. Only used in combination with q.<br><ul><li>true - Performs fast prefix-enabled search using only primary and, if available, alternate names (alternate names currently available for ONET and skills).</li><li>false - Performs more extensive search using both name(s) and, if available, description (description currently only available for SOC and ONET search).</li></ul>

limitinteger

How many search results to return.

soc_version'soc_2021' | 'soc_emsi_2019'

Specify SOC taxonomy version to use.

onet_version'onet_2019' | 'onet_2010'

Specify ONET taxonomy version to use.

title_version'emsi'

Specify Job Title taxonomy version to use.

company_version'emsi_company'

Specify company taxonomy version to use.

naics_version'naics_std_2022'

Specify NAICS taxonomy version to use.

new_taxonomy_versionstrue | false

Use new taxonomy versions.

soc_lightcast_version'2010.2019.0' | '2018.2021.0'

Specify SOC Lightcast taxonomy version to use.

onet_standard_version'2019.0.0' | '2010.0.0'

Specify ONET Standard taxonomy version to use.

Response

OK

Changes

No recorded changes to this operation across all 1 revision of this API.