/totals
Get summary metrics on all postings matching the filters.
POST /totals
POST /totals| Name | Type | Description |
|---|---|---|
soc_version | enum | Specify SOC taxonomy version to use. This parameter is optional. Default: Must be one of: |
area_version | enum | Specify area taxonomy version to use. This parameter is optional. Default: Must be one of: |
title_version | enum | Specify Job Title taxonomy version to use. This parameter is optional. Default: Must be one of: |
company_version | enum | Specify company taxonomy version to use. This parameter is optional. Default: Must be one of: |
new_taxonomy_versions | enum | Use new taxonomy versions. This parameter is optional. Must be one of: |
lot_version | enum | Specify LOT taxonomy version to use. This parameter is optional. Must be one of: |
Request Body
{
"filter": {
"when": {
"start": "2020-01",
"end": "2020-03"
},
"city_name": [
"London, England"
],
"title_name": [
"Staff Nurses"
]
},
"metrics": [
"unique_companies",
"unique_postings",
"median_posting_duration"
]
}Code Examples
curl --request POST \
--url https://api.lightcast.io/uk-jpa/totals \
--header 'Authorization: Bearer <ACCESS_TOKEN>' \
--header 'Content-Type: application/json' \
--data '{ "filter": { "when": { "start": "2020-01", "end": "2020-03" }, "city_name": [ "London, England" ], "title_name": [ "Staff Nurses" ] }, "metrics": [ "unique_companies", "unique_postings", "median_posting_duration" ] }'Response Examples
{
"data": {
"totals": {
"median_posting_duration": 36,
"unique_companies": 335,
"unique_postings": 1350
}
}
}//Your request wasn't valid (bad parameter names or values).
{
"errors": [
{
"status": 400,
"title": "Malformed Request",
"detail": "Expected array"
}
]
}//Your request wasn't unauthorized.
{
"errors": [
{
"status": 401,
"title": "Unauthorized Request",
"detail": "You are not authorized to access this resource."
}
]
}//Your request wasn't valid (bad keyword expression).
{
"errors": [
{
"status": 422,
"title": "Invalid request content",
"detail": "Invalid keyword search expression syntax:\n\t\"general merchandise\" OR \"apparel\" OR \"grocery\" OR\n\t ^"
}
]
}