Sample Profiles

post

https://api.lightcast.io/profiles/samples

Get a sample of individual profiles that match a set of filters. This endpoint requires additional permissions. Please contact your account manager to learn more or fill out our contact form here.

Query Params

area_version

string

enum

Defaults to us_area_2024_4

Specify Area taxonomy version to use.

Allowed:

soc_version

string

enum

Defaults to soc_2021

Specify SOC taxonomy version to use.

Allowed:

title_version

string

enum

Defaults to emsi

Specify Job Title taxonomy version to use.

Allowed:

cip_standard_version

string

enum

Defaults to 2020.0.0

Specify CIP standard taxonomy version to use.

Allowed:

cip_version

string

enum

Defaults to cip2010

Specify CIP taxonomy version to use.

Allowed:

company_version

string

enum

Defaults to emsi_company

Specify company taxonomy version to use.

Allowed:

onet_version

string

enum

Defaults to onet_2019

Specify ONET 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_us_version

string

enum

Defaults to 1.0.3

Specify US 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

length ≥ 1

limit

integer

1 to 100

Defaults to 10

offset

integer

≥ 0

Defaults to 0

Samples can only be viewed up to the 10,000th profile matching your filter (i.e. offset + limit <= 10,000).

Maximum number of returned profiles will always be 10,000 - limit

Responses

200OK

400bad request

403forbidden request

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