Nested Rankings

post

https://api.lightcast.io/global-profiles/rankings/{rankingFacet}/rankings/{nestedRankingFacet}

Get a nested ranking (e.g. top companies, then top skills per company).

Path Params

rankingFacet

string

enum

required

nestedRankingFacet

string

enum

required

Query Params

new_taxonomy_versions

boolean

enum

Defaults to false

Use new taxonomy versions.

Allowed:

lot_version

string

enum

Defaults to 7

Specify LOT taxonomy version to use.

Allowed:

naics_version

string

enum

Defaults to naics_std_2022

Specify NAICS taxonomy version to use.

Allowed:

area_version

string

enum

Defaults to lf_area_2025_1

Specify area taxonomy version to use.

Allowed:

area_laa_version

string

enum

Defaults to 2

Specify LAA area taxonomy version to use.

Allowed:

Body Params

filter

object of objects

required

An object or a list of up to 10 objects.

rank

object

required

nested_rank

object

required

Responses

Language

Credentials

OAuth2

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200ok

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

404The facet you requested wasn't found.

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

500The service is not healthy (e.g. can't connect to datastore).