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/uk-jpa
  • URL
    https://api.lightcast.io/uk-jpa/taxonomies/{facet}
  • Auth
    OAuth 2
    Client credentials
    Token URL: https://auth.emsicloud.com/connect/token scopes: postings:uk

Path parameters

facet'city' | 'company' | 'country' | 'edulevels' | 'employment_type' | 'lau1' | 'lot_career_area' | 'lot_occupation_group' | 'lot_occupation' | 'lot_specialized_occupation' | 'nuts1' | 'nuts3' | 'remote_type' | 'skill_categories' | 'skill_subcategories' | 'skills' | 'soc1' | 'soc2' | 'soc3' | 'soc4' | 'title' | 'ttwa' | 'uk_sic' 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.

soc_version'uk_soc_2020'

Specify SOC taxonomy version to use.

title_version'emsi'

Specify Job Title taxonomy version to use.

company_version'emsi_company'

Specify company taxonomy version to use.

lot_version'6' | '7'
Example:7

Specify LOT taxonomy version to use.

area_version'uk_area_2015'

Specify area taxonomy version to use.

new_taxonomy_versionstrue | false

Use new taxonomy versions.

Response

OK

Changes

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