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

lotVersionstring

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

Response

{"stackTrail":"paths:/jobs/us/{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}],"onet-id":"11-3021.00","total-companies-posting":11,"total-unique-postings":500},"id":"11-3021.00","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
        }
      ],
      "onet-id": "11-3021.00",
      "total-companies-posting": 11,
      "total-unique-postings": 500
    },
    "id": "11-3021.00",
    "type": "timeseries"
  }
}