Get postings

post

https://api.lightcast.io/ca-jpa/postings

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.

Note that the score field is based on posting relevance to your query. Many fields have a single value per posting so relevance scores will be the same for all postings that match those filters. Score variance occurs when a filter is provided that can match a subset of the values in a particular field, filters such as keyword and skills provide such functionality. Only the first 200 values per filter will be used for relevance scoring.

To request more postings please contact us here.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

noc_version

string

enum

Defaults to ca_noc2021

Specify NOC taxonomy version to use.

Allowed:

company_version

string

enum

Defaults to emsi_company

Specify company taxonomy version to use.

Allowed:

area_version

string

enum

Defaults to ca_area_sgc2016

Specify area taxonomy version to use.

Allowed:

area_ca_version

string

enum

Defaults to 2021.0.0

Specify area taxonomy version to use.

Allowed:

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_2017

Specify NAICS taxonomy version to use.

Allowed:

naics_standard_version

string

enum

Defaults to 2017.0.1

Specify NAICS taxonomy version to use.

Allowed:

Body Params

filter

required

An object or a list of up to 10 objects.

fields

array

length ≥ 1

Defaults to id,posted,expired,body,city_name,company_name,title_raw,url,score

See /meta postingsFields for available fields.

Posting fields returned in the response

limit

integer

≥ 1

Defaults to 10

Maximum: 10 (or more for authorized consumers)

order

array

length ≥ 1

Defaults to score,posted

Postings are sorted with respect to the order of the provided keys.

score - sort postings according to their relevance to the request filter.
posted - sort postings by their posted dates.

I.e. using an order of ["score", "posted"] will sort postings first by their score then sort the ones with the same score by posted dates.

The order in which to sort the search results

page

integer

≥ 1

Defaults to 1

Responses

200OK

400bad request

401unauthorized request

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