Jobiqo AIR: XML interface specification – Jobiqo AIR

JOBIQO AIR provides an interface for an automated import of job ads. Information about the XML structure and other details can be found below.

1. XML feed structure

The XML file is hierarchically structured and includes all published job ads that need to be included in jobiqo AIR. The XML file has a maximum file size of 42MB and should contain a maximum of 10,000 jobs.

In the following example a simple structure for the XML feed is demonstrated.

<?xml version="1.0" encoding="UTF-8"?>

<jobs>

<job>

<job_url><![CDATA[https://example.com/link-to-job-ad]]></job_url>

</job>

<job>

….

</job>

</jobs>

In the first line the XML declaration (<?xml version="1.0" encoding="UTF-8"?>) is placed, followed by the root tag <jobs>. Within <jobs>, one or more job ads are listed, each one grouped by the <job> tag.

Note: You can use any names for the XML tags, this is just an example. Jobiqo creates a mapping to whatever XML tag names you are using.

The <job> tag contains the following fields:

Tag	Description	Value	Required	Limits
<id>	A unique identifier for the job ad. If not available <URL> is used instead.	unformatted free text	<id> or <url> are required
<title>	Title of the job ad.	unformatted free text (HTML tags not allowed)	required	Maximum 255 characters
<job_url>	URL to the publicly accessible job ad. And has to be https (not http)	valid URL	required
<logo>	URL to logo.	valid URL	optional (if not provided jobiqo AIR will try to parse it from the Google-for-Jobs annotation)	The job logos should respect file size limit which is 5 MB and should be valid png, gif, jpg, jpeg extension.
<location>	Location, e.g. city name without postal code.	unformatted free text	required
<country>	Country of location	unformatted free text	optional	Any valid country name
<description>	Textual description of the job. If no description is provided job from <url> will get integrated through an iframe.	free Text (basic HTML allowed: br, strong, ul, ol, li, h1, h2, ..)	optional - for Job via URL required - for job per template	Maximum 32000 characters
<organization>	Name of the company	unformatted free Text	optional
<occupationalFie lds>	Profession	multiple values possible	optional
<industryFields>	Industry fields	multiple values	optional

		possible
<employmentTy pes>	Employment type	multiple values possible	optional
<fieldsOfStudy>	Required education	multiple values possible	optional

<workExperience>	Required work experience	single value	optional
<languages>	Required languages	multiple values possible	optional
<skills>	Required skills	multiple values possible	optional
<degreeLevel>	Degree level	free text	optional
<salary>	Gross monthly salary in Euro	integer / text value	optional

All values within the XML tags should be wrapped with <![CDATA[ ]]>, as this avoids possible conflicts with special characters, like “<” or “&”.

Try to provide as many fields as possible, as this will improve the categorization.

2. Character Encoding

The XML file must be UTF-8 encoded (see <?xml version="1.0" encoding="UTF-8"?> at the beginning of the XML).

3. Validation

In order to successfully import the jobs, the XML file must be valid. You can validate your XML file by using services such as http://www.w3schools.com/xml/xml_validator.asp

4. Workflow

The XML file must be accessible via the Internet. We recommend that you host the file on your domain / webspace, e.g. http://example.com/job-export.xml

You can protect the access to the XML file by using a HTTP Basic Authentication password. In this case, please send us the login information.

Jobs are added to a jobiqo AIR campaign once they are included to the XML feed. If the job is removed from the feed, this campaign ends. If the same job is added again later, a new campaign with a new budget is started.