POST /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.
To request more postings please contact us here.
<div class="internal-only">Posting Data Source Access and Limits
There are two types of posting data that clients can have access to; Lightcast-source posting data, and non-Lightcast-source. Give postings:early_feed_access claim of type scope to a client to grant access to Lightcast-source posting data.
To restrict their access to only expired posting data, give postings:only_expired_samples claim.
By default all clients can view up to a total of 10 postings. The limit can be changed through a postings:samples_full_access claim. The claim postings:samples_full_access alone increases the total limit to 100 postings. To increase the limit to 1000, grant postings:samples_full_access:1000.
</div>Request
- Base URLhttps://api.lightcast.io/jpa
- URLhttps://api.lightcast.io/jpa/postings
- AuthOAuth 2Client credentialsToken URL: https://auth.emsicloud.com/connect/token scopes: postings:us
Query parameters
Specify SOC taxonomy version to use.
Specify ONET taxonomy version to use.
Specify Job Title taxonomy version to use.
Specify company taxonomy version to use.
Specify NAICS taxonomy version to use.
Use new taxonomy versions.
Specify SOC Lightcast taxonomy version to use.
Specify ONET Standard taxonomy version to use.
Specify LOT taxonomy version to use.
Request body
Example request
{
"filter": {
"active_sources_info": {
"type": "Company",
"source": "ABCRecruiting.com",
"url": "ABCRecruiting.com/job/GNkBaDoMWiyQbmlpFHfz"
},
"when": {
"start": "2018-06",
"end": "2019-06"
},
"keywords": {
"query": "work/life balance"
},
"company_is_staffing": true,
"min_years_experience": {
"lower_bound": 1,
"upper_bound": 3
},
"max_years_experience": {
"lower_bound": 4,
"upper_bound": 6
},
"salary": {
"lower_bound": 60000,
"upper_bound": 70000
},
"min_salary": {
"lower_bound": 55000,
"upper_bound": 80000
},
"max_salary": {
"lower_bound": 55000,
"upper_bound": 80000
},
"posting_duration": {
"upper_bound": 30
},
"is_supervisor": true,
"is_internship": true,
"is_fortune100": true,
"is_fortune500": true,
"is_fortune1000": true,
"is_hwol": true
}
}Response
OK
Changes
No recorded changes to this operation across all 1 revision of this API.