Libraries

To reduce application complexity, improve stability and availability it can be useful to access the Taxonomy using one of the provided libraries. These libraries are build by performing standard queries against the default production endpoint and packaging the result into libraries that are deployed into the appropriate package managers.

Here is an overview of the queries used for the platforms concerned.

.NET

The .NET Taxonomy contains a subset of the taxonomy presented in library form consumable from .NET.

Country

Country

query region_country_continent {
  concepts(type: "country", include_deprecated: true) {
    id
    deprecated
    preferred_label
    iso_3166_1_alpha_3_2013
    iso_3166_1_alpha_2_2013
  }
}

Language

Language

query language {
  concepts(type: "language", include_deprecated: true) {
    id
    type
    deprecated
    preferred_label
    iso_639_1_2002
    iso_639_2_1998
    iso_639_3_2007
  }
}

Region

Region

query region_country_continent {
  concepts(type: "region", include_deprecated: true) {
    id
    deprecated
    preferred_label
    nuts_level_3_code_2021
    national_nuts_level_3_code_2019
    broader(type: "country", include_deprecated: true) {
      id
    }
  }
}

Occupation name to ESCO ID

Occupation name to ESCO ID

# This needs to confirm to the ESCO ID Selection algorithm to be valid.
query occupation_name_to_esco {
  concepts(type: "occupation-name", include_deprecated: true) {
    id
    preferred_label
    type
    no_esco_relation
    exact_match {
      id
      esco_uri
      preferred_label
      type
    }
    broad_match {
      id
      esco_uri
      preferred_label
      type
    }
    broader {
      id
      esco_uri
      preferred_label
      type
    }
    narrow_match {
      id
      esco_uri
      preferred_label
      type
    }
    close_match {
      id
      esco_uri
      preferred_label
      type
    }
  }
}

Skill to ESCO ID

Skill to ESCO ID

query skill_to_esco {
  concepts(type: "skill", include_deprecated: true) {
    id
    preferred_label
    type
    no_esco_relation
    exact_match {
      id
      esco_uri
      preferred_label
      type
    }
    broad_match {
      id
      esco_uri
      preferred_label
      type
    }
    broader {
      id
      esco_uri
      preferred_label
      type
    }
    narrow_match {
      id
      esco_uri
      preferred_label
      type
    }
    close_match {
      id
      esco_uri
      preferred_label
      type
    }
  }
}