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/ca/{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.

languagestring

Specifies the language base of the data to return. Valid language values are en or fr, and multiple languages may be appended as a comma-separated list. Defaults to all available language-tagged data.

Response

{"stackTrail":"paths:/jobs/ca/{level}/{geoId}/{careerCode}/skills:get:responses:200:content:application/json:schema","oasType":"schema","type":"unknown","example":{"data":{"attributes":{"date-range":{"start":"2022-04","end":"2023-01","months":9,"context":"9 months"},"skills":[{"name":"JavaScript (Programming Language)","unique-postings":1591},{"name":"Front End (Software Engineering)","unique-postings":1182},{"name":"Cascading Style Sheets (CSS)","unique-postings":1162},{"name":"Computer Science","unique-postings":1082},{"name":"React.js (Javascript Library)","unique-postings":1033},{"name":"Agile Methodology","unique-postings":978},{"name":"Application Programming Interface (API)","unique-postings":978},{"name":"HyperText Markup Language (HTML)","unique-postings":918},{"name":"Java (Programming Language)","unique-postings":788},{"name":"Software Engineering","unique-postings":718}],"total-unique-postings":3252,"noc-id":"21234"},"id":"21234","type":"skills"}}}

Example response

{
  "data": {
    "attributes": {
      "date-range": {
        "start": "2022-04",
        "end": "2023-01",
        "months": 9,
        "context": "9 months"
      },
      "skills": [
        {
          "name": "JavaScript (Programming Language)",
          "unique-postings": 1591
        },
        {
          "name": "Front End (Software Engineering)",
          "unique-postings": 1182
        },
        {
          "name": "Cascading Style Sheets (CSS)",
          "unique-postings": 1162
        },
        {
          "name": "Computer Science",
          "unique-postings": 1082
        },
        {
          "name": "React.js (Javascript Library)",
          "unique-postings": 1033
        },
        {
          "name": "Agile Methodology",
          "unique-postings": 978
        },
        {
          "name": "Application Programming Interface (API)",
          "unique-postings": 978
        },
        {
          "name": "HyperText Markup Language (HTML)",
          "unique-postings": 918
        },
        {
          "name": "Java (Programming Language)",
          "unique-postings": 788
        },
        {
          "name": "Software Engineering",
          "unique-postings": 718
        }
      ],
      "total-unique-postings": 3252,
      "noc-id": "21234"
    },
    "id": "21234",
    "type": "skills"
  }
}