Dataset description:
Dataset lists available job postings/openings published on selected portals, provided these can be linked to a company operating on the local market. The coverage of portals/sources differs across country markets and so does the historical data. By default, we publish 12 months of history. Requesting more historical data is possible through your customer representative and is subject to additional fees. Details of the advertised job position such as salary range, list of benefits etc. are subject to availability on the portal and our ability to provide such data in a structured form. In a large majority of cases, such data is available in the description field in its raw form.
All job postings are linked to the original URL. We validate availability of the job posting on a regular basis. If a URL is unavailable, deactivated or job posting is unpublished, we invalidate the record by populating the validTo field. This process has varying accuracy as each portal has a different unpublishing schedule. The user should expect some delay and minor inaccuracies.
For selected country markets, a classification model is applied to job postings, assigning a majority of them to one or more industry categories. Jobpostings can be assigned to the ISCO classification tree, typically at official labour office portals.
Availability:
cz,sk
Dataset updates:
Commonly, job postings are fast flowing data and whenever technically feasible, we publish updates bi-weekly.
Endpoint variables description:
| Item commercial name | Path | Item description | Example | Always populated |
|---|---|---|---|---|
| Job posting unique ID | data/ data/ uniqueId | BizMachine ID unique across countries | cz-jobposting-jobscz2338769 | Yes |
| Publishing entity unique ID | data/ data/ company/ uniqueId | Entity, which has published (is the subject) of the financial report BizMachine ID unique across countries | cz-company-14615100 | Yes |
| Publishing entity national ID | data/ data/ company/ nationalIn | Entity, which has published (is the subject) of the financial report national ID | 14615100 | No |
| Publishing entity name | data/ data/ company/ name | MAPRO spol. s r.o. | No | |
| Job posting title | data/ data/ title | SERVISNÍ TECHNIK vstřikovacích lisů na plasty | Yes | |
| Job posting description | data/ data/ description | CO BUDETE DĚLAT:\r\nservisovat vstřikovací lisy na plasty a průmyslové roboty… | No | |
| Job posting URL on source | data/ data/ url | https://www.jobs.cz/rpd/1588851798/?searchId=156be252-f353-4812-8f1b-c46974779d41&rps=233 | Yes | |
| Job posting keywords | data/ data/ keywords | currently not used | null | No |
| Job posting category (code) | data/ data/ categories/ code | Enumeration code for /api/v3/job-postings/enums/categories | jcz29 | Inherited |
| Job posting category (label) | data/ data/ categories/ name | Machinery-related | No | |
| Job position location as on source | data/ data/ location/ text | Bystrovany | Inherited | |
| Job position location processed code | data/ data/ location/ locality/ code | Enumeration code for /api/v3/enums/localities | null | Inherited |
| Job position location processed name | data/ data/ location/ locality/ name | Enumeration name for /api/v3/enums/localities | null | Inherited |
| Job salary as on source | data/ data/ salary/ text | currently not used | 16000.00 | Inherited |
| Job salary processed lower bound amount | data/ data/ salary/ rangeValue/ lowerBound/ amount | currently not used | 16000 | Inherited |
| Job salary processed lower bound currency | data/ data/ salary/ rangeValue/ lowerBound/ currency | currently not used | CZK | Inherited |
| Job salary processed upper bound amount | data/ data/ salary/ rangeValue/ upperBound/ amount | currently not used | 16000 | Inherited |
| Job salary processed upper bound currency | data/ data/ salary/ rangeValue/ upperBound/ currency | currently not used | CZK | Inherited |
| Job salary processed periodicity | data/ data/ salary/ period | currently not used | monthly | Inherited |
| Job salary single value amount | data/ data/ salary/ singleValue/ amount | currently not used | Inherited | |
| Job salary single value currency | data/ data/ salary/ singleValue/ currency | currently not used | Inherited | |
| Job posting validity start date | data/ data/ validFrom | 2022-01-07T23:17:15.13994+00:00 | Yes | |
| Job posting validity end date | data/ data/ validTo | 2022-03-08T23:52:39.62546+00:00 | No | |
| Job position isco classification (code) | data/ data/ isco/ code | Enumeration code for /api/v3/job-postings/enums/isco-codes (currently not used) | 01 | Inherited |
| Job position isco classification (name) | data/ data/ isco/ name | Enumeration name for /api/v3/job-postings/enums/isco-codes (currently not used) | Inherited | |
| Job position employment type | data/ data/ employmentType | Full-time, part-time, termed contract, etc. (currently not used) | unknown | No |
| Job position number of shifts | data/ data/ shifts | How many shifts is the job worked in | 1 | No |
| Job posting position count | data/ data/ positionsCount | currently not used (0 is the default value) | 0 | No |
| Job posting benefits advertised (code) | data/ data/ benefits/ code | currently not used | meals | Inherited |
| Job posting benefits advertised (name) | data/ data/ benefits/ name | currently not used | No | |
| Job posting requirements (code) | data/ data/ requirements/ code | currently not used | null | Inherited |
| Job posting requirements (name) | data/ data/ requirements/ name | currently not used | null | No |
| Job posting requirements (value) | data/ data/ requirements/ value | currently not used | null | No |
| Job posting contacts | data/ data/ contacts | currently not used | null | No |
| Company.NationalIn | string or null National identifier of the company. |
| Company.Tag.Uid | string or null <uuid> Unique identifier. |
| Categories.Code | Array of strings or null A category code of the job. |
| Sources.Code | Array of strings or null A source code of the job. |
| Source | string or null Deprecated Code of the job source. This parameter is obsolete. Use Sources instead. |
| IncludeExpired | boolean Should results include expired job postings? Default: false |
| Updated.From | string or null <date-time> Search data by System.DateTimeOffset starting from this value. |
| Updated.To | string or null <date-time> Search data by System.DateTimeOffset up to this value. |
| Offset | integer <int32> Allows to specify offset from where to start streaming results. Default value: 0 |
| Limit | integer <int32> Default: 200 Allows to specify limit of returned data. |
| SortBy | string or null Sorting order and field to sort by in format sorting-order Valid orders: desc, asc. Example: desc(createdAt) |
Success
{- "paging": {
- "totalItems": 0,
- "totalPages": 0,
- "pageSize": 0,
- "currentPage": 0,
- "maxPageSize": 0
}, - "data": [
- {
- "data": {
- "uniqueId": "cz-jobposting-123456",
- "company": {
- "nationalIn": "string",
- "uniqueId": "string",
- "name": "string"
}, - "title": "string",
- "description": "string",
- "url": "string",
- "keywords": [
- "string"
], - "categories": [
- {
- "code": "string",
- "name": "string"
}
], - "location": {
- "text": "\"Zkumavka s.r.o. - pracoviště Bouda",
- "locality": {
- "code": "CZ0712",
- "name": "string",
- "types": [
- "string"
], - "parent": { }
}
}, - "salary": {
- "text": "16000.00",
- "singleValue": {
- "amount": 0,
- "currency": "string"
}, - "rangeValue": {
- "lowerBound": {
- "amount": 0,
- "currency": "string"
}, - "upperBound": {
- "amount": 0,
- "currency": "string"
}
}, - "period": "Unknown"
}, - "validFrom": "2019-08-24T14:15:22Z",
- "validTo": "2019-08-24T14:15:22Z",
- "isco": {
- "code": "string",
- "name": "string"
}, - "employmentType": "Unknown",
- "shifts": 1,
- "positionsCount": 0,
- "benefits": [
- {
- "code": "meals",
- "name": "string",
- "value": "stravování"
}
], - "requirements": [
- {
- "code": "education",
- "name": "string",
- "value": "elementary"
}
], - "contacts": [
- {
- "type": "Unknown",
- "value": "tel.: 111 490 001, e-mail: firma123@email.com"
}
]
}, - "meta": {
- "dataSources": [
- {
- "code": "string",
- "name": "string",
- "externalId": "string",
- "url": "string"
}
], - "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "prospector": {
- "link": "string"
}, - "hash": "string"
}
}
]
}