Taxonomies

Search taxonomies

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

get/taxonomies/{facet}

Request

  • Base URL
    https://api.lightcast.io/global-profiles
  • URL
    https://api.lightcast.io/global-profiles/taxonomies/{facet}
  • Auth
    OAuth 2
    Client credentials
    Token URL: https://auth.emsicloud.com/connect/token scopes: profiles:global

Path parameters

facet'company' | 'gender' | 'skills' | 'title' | 'schools' | 'nation' | 'market' | 'onet' | 'occupation' | 'lot_specialized_occupation' | 'lot_career_area' | 'lot_occupation' | 'lot_occupation_group' | 'laa_metro' | 'laa_country' | 'laa_admin_area_1' | 'laa_admin_area_2' 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 skills).</li><li>false - Performs more extensive search using both name(s) and, if available, description (description currently only available for NOC search).</li></ul>

limitinteger

Set number of search results to return.

newTaxonomyVersionstrue | false

Use new taxonomy versions.

lot_version'6' | '7'

Specify LOT taxonomy version to use.

area_version'lf_area_2023_2' | 'lf_area_2025_1'
Example:lf_area_2025_1

Specify area taxonomy version to use.

area_laa_version'1' | '2'
Example:2

Specify LAA area taxonomy version to use.

Response

OK

Changes

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