Adzuna

Adzuna XML specifications

General Notes

Generic principles regarding the XML files that Adzuna accepts:

Delivery

The XML file can be made available through a url (it can be password protected) and Adzuna will download it, or alternatively it can be uploaded to Adzuna's FTP server.

To upload a file to Adzuna's FTP server, an IP that Adzuna will whitelist must be provided. The whitelisted IP must be used to upload the XML file and any effort to upload from a non-whitelisted IP will fail.

Adzuna will download the XML file and update the search engine at least once per day, and therefore the file you produce must be updated with at least that frequency.

Compressing the XML file with a well-known compression algorithm like gz or zip is highly preferable.

Well-formed XML

The XML provided for inclusion must be a well structured and valid XML document. Many freely available tools provide XML validation.

For Linux systems an XML file can be validated with:

$ xmllint --noout test.xml

XML declaration

The usage of an XML declaration is highly preferable:

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

File encoding

Data encoded in Unicode is highly preferable. Declaring the encoding of the content data in the XML declaration is also highly preferable.

CDATA

Adzuna is flexible and accepts XML files both with and without CDATA sections.

If CDATA sections are not used, make sure that the content of the XML tags is properly escaped. Left angle brackets and ampersands may not occur in their literal form and must be escaped using "<" and " &" (more details).

XML structure

Jobs

This section describes the structure of a job XML file

Root Element and job ad

The root element is <jobs> and each ad should be enclosed in a <job> tag. Example:

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

    <job>
    ...
    </job>

    <job>
    ...
    </job>

</jobs>

Job ad fields

XML tag	Type	Notes
title	Mandatory	Job title. This should be an actual job title and should not include a location, salary, ID number or any keywords e.g. help wanted, urgent etc. as this will impact search relevancy when Adzuna users are looking for your jobs.
id	Mandatory	Unique identifier of the ad from the original.
description	Mandatory	Description of the job, this should contain html formatting as opposed to plain text and must be minimum 100 characters. Any inappropriate or offensive content will be removed from Adzuna.
url	Mandatory	URL of the job from the original site, this must be a unique URL directing the user to a job description with the ability to apply online for the job. Tracking parameters (e.g. utm_source=adzuna) can be included in the original XML or requested to be appended by Adzuna.
location	Mandatory	Location of the job. We can accept "raw" locations like: "10 Downing St, London SW1A 2AA, United Kingdom", "London SW1A 2AA", "London" Ideally this should only include one value which should be the closest suburb, town or city to the job. This allows us to accurately map the job to the most relevant location in our database. If multiple locations appear within one tag then we will only use the first location supplied.
geo_lat		If the latitude of the ad's location is available, then having it in a number format is highly preferable. The lat/lng will be taken into account only if both are present for the ad.
geo_lng		If the longitude of the ad's location is available, then having it in a number format is highly preferable. The lat/lng will be taken into account only if both are present for the ad.
postcode		If the postcode of the ad is available, then having it in a separate XML tag is highly preferable.
country	Mandatory	Country the job is located in. ISO_3166-1 country codes are highly preferable. If custom country identifiers are supplied ("UK", "United Kingdom") they must used consistently throughout the file. Mixing different custom country identifiers for the same country may result in jobs being rejected. Adzuna supports the following 16 countries: AU, AT, BR, CA, FR, DE, IN, IT, NL, NZ, PL, RU, SG, ZA, UK, US. In a case where a file has multiple countries we will only ever map jobs that are within that country, e.g. a job in Munich with a country code of UK will be rejected.
salary	Highly preferable	Salary of the job preferably in the format "£20,000 per annum" We can also accept raw salary values including text e.g. "150 € per day", "50K", "50K + benefits". For UK jobs where no salary is provided then Adzuna will apply a Jobsworth market estimate which is based on keywords, categories, companies and locations.
salary_min		If a salary range is available, then having the minimum salary in a number format is highly preferable.
salary_max		If a salary range is available, then having the maximum salary in a number format is highly preferable.
salary_frequency		If a salary frequency is available, then having it as a separate XML tag is highly preferable. Acceptable values: hour day month year
salary_currency		If a currency is available, then having it as a separate XML tag is highly preferable.
company	Highly preferable	The employer for the job ad. Recruitment agencies or job site names should not be included.
category	Highly preferable	The category (or job industry) the ad belongs to. Strings (category labels) or integers (category ids) are accepted. Only one value can be supplied. The following types are available. Adzuna's own categories. See Job Categories section for more details The original site's categories. If the original site's categories are used the following must be taken care of: A mapping of the original site's categories to Adzuna's categories should be provided. See Job Categories section for more details The original site's categories must not change dynamically. Ad-hoc adding categories is not supported. If this data is not provided then we will be unable to surface your jobs to our users when they search using these filters on Adzuna Note: in the UK & US we automatically categorise ads using a Data Science model based on title/descriptions which supersedes any category data supplied in an xml feed.
contract_type		Only one value can be supplied. Acceptable values: permanent contract If this data is not provided then we will be unable to surface your jobs to our users when they search using these filters on Adzuna
contract_time		Only one value can be supplied. Acceptable values: full_time part_time If this data is not provided then we will be unable to surface your jobs to our users when they search using these filters on Adzuna
date		The initial publication date of the ad. If this reflects the last modification time of the ad it will be taken into account only the first time it's encountered.
cpc		For those advertisers who can support programmatic bidding this field should contain the cpc you would like to pay per job and should be in the format 0.20. Your account manager will agree a cpc range upfront with you giving you the ability to bid within a min/max range when advertising with us.