Job
Overview
Job describes a job opening. The following fields are used as part of our job matching algorithms: job title, employer, industry, skills and certifications, experience requirements, and educational credentials requested. The remaining fields may be used to filter job postings to align with a candidate’s preferences.
Schema
Each candidate may have one or more jobs with the following inputs outlined as a work experience.
FIELD | TYPE | SHORT DESCRIPTION |
---|---|---|
job_id | string | Unique ID for the job. |
job_title | string | Free text of the job title. |
occupation_code | string | O*NET occupation code for the job. |
employer_name | string | The name of the employer. (This is used to find the industry of this work experience.) |
naics | string | NAICS industry code for the employer. |
education | object | Preferred or required educational credentials. For schema information, see job education. |
skills | array of strings | List of required or preferred skills from AdeptID’s skill taxonomy. |
experience_min | float | The minimum number of years of experience requested. |
experience_max | float | The maximum number of years of experience requested. |
posting_body | string | Text description of the job posting. |
salary_min | float | Advertised min salary for the role. |
salary_max | float | Advertised max salary for the role. |
salary_period | enum | The pay increment of the advertised salary. The acceptable values are hourly, weekly, monthly, and annual. |
currency | enum | Currency of the salary, from list of alpha codes (e.g., USD) according to ISO 4217. |
remote | boolean | Whether the job is remote (vs in-person). |
locations | array of objects | Locations of the role. (For schema information see location.) |
date_posted | date | The date the role was first posted. |
date_expired | date | The date the role was expired or the job posting was taken down. |
is_internship | boolean | Whether the role is an internship. |
is_staffing | boolean | Whether the role is advertised by a staffing firm (vs the hiring employer). |
full_time | boolean | Whether the role is full-time. |
urls | array of strings | URLs from the job posting. |
contact_info | object | Contact information provided in the job posting. For schema information, see Contact Info. |
Job Example
{
"job_id": "job_1",
"job_title": "Marketing Associate",
"skills": [
"Marketing", "copywriting", "hubspot CRM","Digital Marketing"
],
"education": [
{
"level": "BACHELORS",
"degree_type": "Bachelor of Arts",
"required": true
},
{
"level": "MASTERS",
"degree_type": "Master of Arts",
"required": false
}
]
}
Updated about 2 months ago