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/us/{level}/{geoId}/{careerCode}/companies

Query parameters

excludestring

The name of a single company you wish to exclude from the results.

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.

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.

limitnumber

Maximum number of company names 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.

lotVersionstring

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

Response

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