v1

latestOpenAPI 3.1.02026-07-242892032.8 MB
Postings

Get individual postings that match your requested filters

Get data for individual postings that match your requested filters. Note that not all fields are present for all postings, and some may be null or "Unknown". The url field is only available for currently active postings, and the destination website is not guaranteed to be secure or functional.

To request more postings please contact us here.

post/postings

Query parameters

soc_version'soc_2021'

Specify SOC taxonomy version to use.

onet_version'onet_2019'

Specify ONET taxonomy version to use.

title_version'emsi'

Specify Job Title taxonomy version to use.

company_version'emsi_company'

Specify company taxonomy version to use.

naics_version'naics_std_2022'

Specify NAICS taxonomy version to use.

new_taxonomy_versionstrue | false

Use new taxonomy versions.

area_version'us_area_2024_3' | 'us_area_2024_4'

Specify Area taxonomy version to use.

area_us_version'1.0.2' | '1.0.3'

Specify US Area taxonomy version to use.

soc_lightcast_version'2018.2021.0'

Specify SOC Lightcast taxonomy version to use.

onet_standard_version'2019.0.0'

Specify ONET Standard taxonomy version to use.

lot_version'7' | '6'

Specify LOT taxonomy version to use.

Request body

limitinteger

Maximum: 10 (or more for authorized consumers)

pageinteger

Example request

{
  "filter": {
    "company_is_staffing": true,
    "is_fortune100": true,
    "is_fortune1000": true,
    "is_fortune500": true,
    "is_hwol": true,
    "is_internship": true,
    "is_supervisor": true,
    "keywords": {
      "query": "work/life balance"
    },
    "max_salary": {
      "lower_bound": 55000,
      "upper_bound": 80000
    },
    "max_years_experience": {
      "lower_bound": 4,
      "upper_bound": 6
    },
    "min_salary": {
      "lower_bound": 55000,
      "upper_bound": 80000
    },
    "min_years_experience": {
      "lower_bound": 1,
      "upper_bound": 3
    },
    "posting_duration": {
      "upper_bound": 30
    },
    "salary": {
      "lower_bound": 60000,
      "upper_bound": 70000
    },
    "when": {
      "end": "2019-06",
      "start": "2018-06"
    }
  }
}

Response

OK