v1

latestOpenAPI 3.1.02026-07-242892032.8 MB

Get Companies Posting Titles 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 1000. The latest data is usually 1 month previous from current date.

get/jobs/ca/{level}/{geoId}/{careerCode}/titles

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.

limitnumber

Maximum number of job titles to return for the given date range. Max and default value for limit is 1000.

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}/titles:get:responses:200:content:application/json:schema","oasType":"schema","type":"unknown","example":{"data":{"attributes":{"titles":[{"name":"Web Designer","unique-postings":15}],"date-range":{"start":"2017-01","end":"2018-01","months":12,"context":"1 year"},"noc-id":"21234"},"id":"21234","type":"titles"}}}

Example response

{
  "data": {
    "attributes": {
      "titles": [
        {
          "name": "Web Designer",
          "unique-postings": 15
        }
      ],
      "date-range": {
        "start": "2017-01",
        "end": "2018-01",
        "months": 12,
        "context": "1 year"
      },
      "noc-id": "21234"
    },
    "id": "21234",
    "type": "titles"
  }
}