Sign in

v1

latestOpenAPI 3.1.02026-07-242892032.8 MB

Get Companies Posting Jobs 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}/companies

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 company names to return for the given date range. Max and default value for limit is 1000.

isStaffingboolean

Passing false filters out postings from companies that have been identified as staffing companies or recruiting agencies; true limits results to only those from staffing or recruiting companies. By default both staffing and non-staffing companies are included in the results.

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.

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

Example response

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