Job Vacancy

Job Vacancy is an enhancement to the ATDW content to combat the labour shortage in the Australian Tourism Industry by enticing working holiday makers and job seekers to visit Australia.

The job vacancy feature will be made available for content curation from 1 July 2022.

Only the minimum set of fields are being introduced to begin with. Further analysis are being conducted to add more fields and improvements to the job vacancy feature soon.

Features:

The search API results can be filtered by profiles that contain jobs and/or job types (casual, contract, full time, part time).
High-level job fields (job id, job type, job name, application close date, job start date and job URL) can be returned in the search API response by passing the field list parameter - "&fl=jobs".
The job items will be removed from the API once the application close date lapses.
Jobs are optional however, a profile may contain up to a maximum of 10 jobs.

Note:

Jobs are applicable to Get Product API endpoint only. In other words, jobs are NOT applicable to the Get Service API endpoint.
The application close date will always be earlier than the job start date.
Job tags are pre-defined attributes that are applicable to the individual State Tourism Organisations (STO) that are based on specific marketing campaign. So, the job tags may not be of relevance to the non-STO distribution network.

Content Standards:

Field	Field Definition	Field Format	Field Limit	Available Options	Mandatory	Example
Job Flag	Indicates if the profile contains the job vacancy	Boolean (true or false)	n/a	n/a	Yes	true
Job ID	Unique reference to the Job item	ID	n/a	n/a	Yes	JOB0000130
Job Type	Type of the Job being offered	Attribute ID	n/a	Casual/Vacation, Contract/Temp, Full Time, Part Time	Yes	Casual/Vacation
Job Name	The name of the Job or position being offered	Alphanumeric	55 characters max	n/a	Yes	Wait Staff
Job Description	Job Description may contain scope of work/duties/responsibilities, working hours, place of work, reporting authority, salary range.	Alphanumeric	Min 20, Max 350 characters	n/a	Yes	We are currently looking for experienced wait staff with great customer service who are willing to work in a busy environment to join our team...
Job Requirements	Job Requirements may contain qualifications, experience and skills required for the position.	Numeric	Min 20, Max 200 characters	n/a	Yes.	Skills and experience to be considered for this role are: Excellent time management skills and the ability to stay clam under pressure...
Application Close Date	Last date to submit the application for the job.	Date (YYYY-MM-DD)	n/a	n/a	Yes	2022/08/31
Job Start Date	Start Date of the job.	Date (YYYY-MM-DD)	n/a	n/a	Yes	2022/10/01
Job URL	Website URL for the Job	Valid URL	n/a	n/a	No	https://www.job.com.au/jobs/5714515
Job Tags	Pre-defined set of tags for the deal	Valid pre-defined attribute(s)	n/a	Featured, Do Not Display	No	Featured

Examples:

Search API Endpoint

Filter profiles containing jobs:

API Request	https://atlas.atdw-online.com.au/api/atlas/products?key=****&additionalQuery=hasJobs:true
Definition	&additionalQuery=hasJobs:true - Filter results by profiles containing job vacancies &additionalQuery=hasJobs:false - Filter results by profiles that does not contain job vacancies
Additional Info	"additionalQuery=hasJobs" is case sensitive.

Filter profiles by job types:

API Request	https://atlas.atdw-online.com.au/api/atlas/products?key=****&att=JOBTYPESFULLTIME
Definition	Find all profiles having at least one Full Time job listed
Additional Info	You can filter the results by multiple job type attribtues using a comma separated list (to apply AND condition) or a pipe separated list (to apply OR condition) Example request payload: &att=JOBTYPESCONTRACT,JOBTYPESCASUAL Find all profiles containing the Job types - Contract and Casual &att=JOBTYPESFULLTIME\|JOBTYPESPARTTIME Find all profiles containing either full time or part time jobs To view the list of available job types, please click here

Filter profiles by job tags:

API Request	https://atlas.atdw-online.com.au/api/atlas/products?key=****&att=JOBTAGSFEATURED
Definition	Find all profiles with at least one job that is tagged as 'featured'.
Additional Info	You can filter the results by multiple job tag attribtues using a comma separated list (to apply AND condition) or a pipe separated list (to apply an OR condition) Example request payload: &att=JOBTAGDONOTDISPLAY,DEALTAGSFEATURED Find all profiles containing the 'featured' and 'do not display' job tags &att=JOBTAGSFEATURED\|JOBTAGSDONOTDISPLAY Find all profiles containing either 'featured' or 'do not display' job tags To view the list of available attributes for Job tags, please click here

Return high-level job fields in the API response:

API Request	https://atlas.atdw-online.com.au/api/atlas/products?key=****&additionalQuery=hasJobs:True&fl=product_id,product_name,jobs
Definition	Find all profiles containing job vacancies and return only profile ID, name and high-level jobs field in the response.
Additional Info	Only the following high-level job fields will be returned in the Search API response. To return full details of the job, please query the Get Product API endpoint. Job ID Job Type Job Name Application Close Date Job Start Date Job URL

Get Product API Endpoint

Retrieve job vacancies for a specific profile:

API Request	https://atlas.atdw-online.com.au/api/atlas/product?key=****&productid=[PRODUCT_ID]
Definition	Retrieve detailed information for the specified product. The response contains up to 10 job associated with the given profile.
Additional Info	-

Static API Endpoint

List of Job Types:

API Request	https://atlas.atdw-online.com.au/api/atlas/attributes?key=****&types=JOBTYPES
Definition	Retrieve all attributes that belong to the attribute type - "Job Types"
Additional Info	-

List of Job Tags:

API Request	https://atlas.atdw-online.com.au/api/atlas/attributes?key=****&types=JOBTAGS
Definition	Retrieve all attributes that belong to the attribute type - "Job Tags"
Additional Info	-