v1

latestOpenAPI 3.1.02026-07-242892032.8 MB

Get Job Posting Timeseries for a Career

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

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

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.

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}/timeseries: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"},"months":[{"month":"2017-01","unique-postings":120}],"noc-id":"21234","total-unique-postings":500,"total-companies-posting":11},"id":"21234","type":"timeseries"}}}

Example response

{
  "data": {
    "attributes": {
      "date-range": {
        "start": "2017-01",
        "end": "2018-01",
        "months": 12,
        "context": "1 year"
      },
      "months": [
        {
          "month": "2017-01",
          "unique-postings": 120
        }
      ],
      "noc-id": "21234",
      "total-unique-postings": 500,
      "total-companies-posting": 11
    },
    "id": "21234",
    "type": "timeseries"
  }
}