Get a ranking of postings by facet values with distributions

post

https://api.lightcast.io/jpa/rankings/{rankingFacet}/distributions/{distributionFacet}

Group and rank postings by {ranking_facet} with a distribution for each ranked item.

Path Params

distributionFacet

enum

required

The facet used as the domain of the distribution.

Allowed:

rankingFacet

enum

required

The facet to rank by.

Query Params

soc_version

string

enum

Defaults to soc_2021

Specify SOC taxonomy version to use.

Allowed:

onet_version

string

enum

Defaults to onet_2019

Specify ONET taxonomy version to use.

Allowed:

title_version

string

enum

Defaults to emsi

Specify Job Title taxonomy version to use.

Allowed:

company_version

string

enum

Defaults to emsi_company

Specify company taxonomy version to use.

Allowed:

naics_version

string

enum

Defaults to naics_std_2022

Specify NAICS taxonomy version to use.

Allowed:

new_taxonomy_versions

boolean

enum

Defaults to false

Use new taxonomy versions.

Allowed:

area_version

string

enum

Defaults to us_area_2024_4

Specify area taxonomy version to use.

Allowed:

area_us_version

string

enum

Defaults to 2.0.0

Specify area taxonomy version to use.

Allowed:

soc_lightcast_version

string

enum

Defaults to 2018.2021.0

Specify SOC Lightcast taxonomy version to use.

Allowed:

onet_standard_version

string

enum

Defaults to 2019.0.0

Specify ONET Standard taxonomy version to use.

Allowed:

lot_version

string

enum

Defaults to 7

Specify LOT taxonomy version to use.

Allowed:

Body Params

filter

required

An object or a list of up to 10 objects.

rank

object

required

distribution

object

required

Responses

200OK

400Your request wasn't valid (bad parameter names or values).

401Your request wasn't unauthorized.

404The facet you requested wasn't found.

422Your request wasn't valid (bad keyword expression).