List Job Posting Timeseries for a Career by POST

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.

post/jobs/ca/{level}/{careerCode}/timeseries

Request

  • Base URL
    https://api.lightcast.io/alumni-pathways
  • URL
    https://api.lightcast.io/alumni-pathways/jobs/ca/{level}/{careerCode}/timeseries
  • Auth
    OAuth 2
    Client credentials
    Token URL: https://auth.emsicloud.com/connect/token scopes: alumni-pathways

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.

Request body

string required

Response

unknown required

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"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.