Sign in

v1

latestOpenAPI 3.1.02026-07-242892032.8 MB

Get Desired Skills for a Career

If no start and end dates are provided, the query will default to the past 6 months. Maximum value for limit parameter is 100. The latest data is usually 1 month previous from current date.

get/jobs/uk/{level}/{geoId}/{careerCode}/skills

Query parameters

startstring

The start date for postings in YYYY-MM format.

endstring

The end date for postings in YYYY-MM format. Must be at least 1 month prior to current month.

skillTypestring

Specifies the type of skills returned. May be either hard or soft. Defaults to hard.

rankingstring

How to rank the skills. May be either intensity or relevance. Intensity rank skills by frequency across all postings (default). Relevance rank skills by significance/uniqueness, i.e. skills that appear more often in this career (NOC) than all the others.

limitnumber

Maximum number of hard skill names to return for the given date range. Max value for limit is 100 and default is 10.

taxonomystring

Specifies the taxonomy of the career code in the request. May be either standard or lot. Defaults to standard.

lotVersionstring

Specifies the version of LOT of the career code in the request.

Response

{"stackTrail":"paths:/jobs/uk/{level}/{geoId}/{careerCode}/skills:get:responses:200:content:application/json:schema","oasType":"schema","type":"unknown","example":{"data":{"attributes":{"date-range":{"start":"2017-01","end":"2018-01","months":12,"context":"1 year"},"soc-id":"2137","skills":[{"name":"Java (Programming Language)","unique-postings":15}],"total-unique-postings":50},"id":"2137","type":"skills"}}}

Example response

{
  "data": {
    "attributes": {
      "date-range": {
        "start": "2017-01",
        "end": "2018-01",
        "months": 12,
        "context": "1 year"
      },
      "soc-id": "2137",
      "skills": [
        {
          "name": "Java (Programming Language)",
          "unique-postings": 15
        }
      ],
      "total-unique-postings": 50
    },
    "id": "2137",
    "type": "skills"
  }
}