LIlightcast
Earnings Data

Employment at Wage by Occupation

This endpoint is similar to the employment_at_wage endpoint but produces results per occupation.

This enables the client to see which occupations have the most jobs at or below a specified wage.

post/v1/us/{datarun}/employment_at_wage_by_occ

Request

  • Base URL
    https://api.lightcast.io/alumni-pathways
  • URL
    https://api.lightcast.io/alumni-pathways/v1/us/{datarun}/employment_at_wage_by_occ
  • Auth
    OAuth 2
    Client credentials
    Token URL: https://auth.emsicloud.com/connect/token scopes: alumni-pathways

Path parameters

datarun'2025.2' | '2025.1' | '2024.4' | '2024.3' | '2024.2' required

Specify datarun version

Request body

areasstring[] required

One or more FIPS codes (if geotype is fips) or ZIP codes (if geotype is zip).

classesinteger[] required

One or more class of worker codes.

geotype'fips' | 'zip' required

Either fips for the FIPS geography taxonomy (nation/state/county) or zip for ZIP codes

occupationsstring[]

One or more codes from the SOC occupation taxonomy. Defaults to all occupations if not provided

wage_per'hourly' | 'annual'

Specify wage type.

wagesstring[] required

Array of wages to estimate employment at. Values should be numeric though represented as strings and in sorted order, low to high.

yearinteger

Earnings year to aggregate; must be one of the available years for the selected datarun. Defaults to latest year

topNinteger

How many occupations (sorted descending by employment) to return for each wage level. Defaults to 10

Response

OK

areasstring[] required
classesinteger[] required
datarunstring required
geotypestring required
occupationsstring[] required
topNinteger

How many occupations (sorted descending by employment) to return for each wage level. Defaults to 10

wage_perstring required
yearstring required

Changes

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