Taxonomy download🔗

The /taxonomy endpoint is a REST service offered via a GET method.

It can be used to download the Professions Normalization Taxonomy (PNT).

Remember to send your authentication token with each request (see Authentication page).

Endpoint🔗

Method	Media	URL	Description
GET	`query string`	`{{domain}}/taxonomy`	Download the PNT

Path parameters🔗

Parameter	Type	Default	Description
`format`	`str`	`json`	The output format (`json` or `csv`)
`language`	`str`	None	The language in which to output the PNT (ISO 639-1 code; see list of supported languages). By default, the PNT is output in all supported locales.

Response🔗

Status	Content type	Content description
`200` (OK)	`application/json`	A JSON object containing the PNT
`200` (OK)	`text/csv`	A CSV file containing the PNT. The filename indicates the service version and taxonomy release.
`400` (Bad request)		The input parameter is incorrect
`404` (Not Found)		The language is not supported
`422` (Validation error)		The input value does not match the expected format or content

Examples🔗

$ curl -s https://api.textkernel.nl/professions/v1/taxonomy \
    -H "Authorization: Bearer $TOKEN" -H "Accept-encoding: gzip" | gzip -d

{
  "codes": [
    {
      "tk": {
        "code_id": "0-1000.123",
        "descriptions": {
          "en": "Software engineer"
        },
        "group": {
          "code_id": "0-1000.123",
          "descriptions": {
            "en": "Software engineer"
          }
        },
        "class": {
          "code_id": "0-1000.123",
          "descriptions": {
            "en": "Software engineer"
          }
        }
      },
      "onet": {
        "code_id": "0-1000.123",
        "descriptions": {
          "en": "Software engineer"
        }
      },
      "isco": {
        "code_id": "0-1000.123",
        "descriptions": {
          "en": "Software engineer"
        }
        ...
      }
    }
  ...
  ],
  "meta": {
    "service_version": "0.0.0",
    "taxonomy_release": "2021-03-04T15:45:55.457Z"
  }
}

$ curl -s https://api.textkernel.nl/professions/v1/taxonomy?format=csv \
    -H "Authorization: Bearer $TOKEN"


tk.code_id,tk.descriptions.en,tk.group.code_id,tk.group.descriptions.en,tk.class.code_id,tk.class.descriptions.en,kldb_2020.code_id,kldb_2020.descriptions.en,isco.code_id,isco.descriptions.en,onet.code_id,onet.descriptions.en,onet_2019.code_id,onet_2019.descriptions.en,uwv_boc.code_id,uwv_boc.descriptions.nl,uk_soc_2010.code_id,uk_soc_2010.descriptions.en,uk_soc_2020.code_id,uk_soc_2020.descriptions.en,ams.code_id,ams.descriptions.de
0-1000.123,Software engineer,0-1000.123,Software engineer,0-1000.123,Software engineer,0-1000.123,Software engineer,0-1000.123,Software engineer,,0-1000.123,Software engineer,0-1000.123,Software engineer,0-1000.123,Software engineer,0-1000.123,Software engineer,0-1000.123,Software engineer,0-1000.123,Software engineer
...

Response fields🔗

Field	Type	Value
`tk.code_id`	`int`	The code id of the TK profession concept
`tk.description.en`	`str`	The description of the TK profession concept in requested locale
`tk.group.code_id`	`int`	The code id of the TK profession group
`tk.group.description.en`	`str`	The description of the TK profession group in requested locale
`tk.class.code_id`	`int`	The code id of the TK profession class
`tk.class.description.en`	`str`	The description of the TK profession class in requested locale
`onet.code_id`	`str`	The code id of the ONET profession concept
`onet.description.en`	`str`	The description of the ONET profession concept in English
`isco.code_id`	`str`	The code id of the ISCO profession concept
`isco.description.en`	`str`	The description of the ISCO profession concept in English
`onet_2019.code_id`	`str`	The code id of the ONET-2019 profession concept
`onet_2019.description.en`	`str`	The description of the ONET-2019 profession concept in English
`kldb_2020.code_id`	`str`	The code id of the KldB-2020 profession concept
`kldb_2020.description.en`	`str`	The description of the KldB-2020 profession concept in English
`uwv_boc.code_id`	`str`	The code id of the UWV profession concept
`uwv_boc.description.nl`	`str`	The description of the UWV profession concept in Dutch
`uk_soc_2010.code_id`	`str`	The code id of the UK-SOC-2010 profession concept
`uk_soc_2010.description.en`	`str`	The description of the UK-SOC-2010 profession concept in English
`uk_soc_2020.code_id`	`str`	The code id of the UK-SOC-2020 profession concept
`uk_soc_2020.description.en`	`str`	The description of the UK-SOC-2020 profession concept in English
`ams.code_id`	`str`	The code id of the AMS profession concept
`ams.description.de`	`str`	The description of AMS profession concept in German

Rate limits🔗

Accounts have a limited request rate. If you exceed the limit you will receive 429 Too Many Requests HTTP responses.

Plan	Limit	Units
Standard	10	Hour
Demo	0	Hour