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
            }
        ]
    }