XML Feed Format

Home » XML Feed Format

Below are the instructions to generate an XML feed that can be submitted to publish your ads within Sercanto search results. If you need more information regarding the XML format you can take a look at Wikipedia.

The XML feed should comply with the following rules:

  1. The coding of the XML feed should be done in UTF-8.
  2. In case your website has ads in more than one countries, you should create a dedicated XML feed for each country.

The XML feed has a tag and items , such items represent the ads that will be included in Sercanto.

All items should consist of the following fields:

  • id: id of the ad on your website (numeric or alphanumeric, it must be unique because we use it to avoid duplicate entries) (required)
  • url: URL of the ad on your website (required – with all necessary tracking parameters like utm) . 
  • title: title of the ad (required)
  • content: description of the ad (body) (required)
  • date: publication date of the ad (format: DD/MM/YYYY) (required)
  • city: city (required – only city name)
  • category: job sector (required)
  • expiration_date: expiration date of the ad (format: DD/MM/YYYY) (optional)
  • address: address (optional)
  • postcode: postcode (optional)
  • city_area: city area(optional)
  • region: county where the job is located (optional)
  • latitude: latitude (optional)
  • longitude: longitude (optional)
  • pictures: the ‘pictures’ (optional) element may contain a set of ‘picture’ tags, each of which contains the following elements:
    • picture_title: title of the picture (optional)
    • picture_url: URL link to the picture on your website
  • salary: ad salary (integer value, between 1 and 100000000) (optional). If the price is specified in a currency other than GBP, a currency tag should be included. This tag enables Sercanto to convert the price to GBP (£).
  • company: hiring company name (optional)
  • working_hours: working hours; full-time, part-time, 8 hours/day (optional)
  • contract: type of contract; permanent, temporary, contract, freelance or internship (optional)
  • experience: required minimum experience; intern, without experience, less than a year, between 1 and 3 years, between 3 and 5 years, between 5 and 8 years or more than 8 years (optional)
  • requirements: other requirements (optional)
  • studies: studies required (optional)

Sercanto doesn’t allow corporate images with information such as “No image available”.
If Sercanto detects these kind of pictures, it has the right to stop the inclusion of your ads.

Example of the XML feed layout:

<?xml version="1.0" encoding="utf-8"?>
<sercanto>
<ad>
<id><![CDATA[...]]></id>
<url><![CDATA[...]]></url>
<title><![CDATA[...]]></title>
<content><![CDATA[...]]></content>
<date><![CDATA[...]]></date>
<expiration_date><![CDATA[...]]></date>
<address><![CDATA[...]]></address>
<postcode><![CDATA[...]]></postcode>
<city_area><![CDATA[...]]></city_area>
<city><![CDATA[...]]></city>
<region><![CDATA[...]]></region>
<latitude><![CDATA[...]]></latitude>
<longitude><![CDATA[...]]></longitude>
<salary currency="EUR"><![CDATA[...]]></salary>
<company><![CDATA[...]]></company>
<category><![CDATA[...]]></category>
<working_hours><![CDATA[...]]></working_hours>
<contract><![CDATA[...]]></contract>
<experience><![CDATA[...]]></experience>
<requirements><![CDATA[...]]></requirements>
<studies><![CDATA[...]]></studies>
<pictures>
<picture>
<picture_url><![CDATA[...]]></picture_url>
<picture_title><![CDATA[...]]></picture_title>
</picture>
<picture>
<picture_url><![CDATA[...]]></picture_url>
<picture_title><![CDATA[...]]></picture_title>
</picture>
...
</pictures>
</ad>
<ad> .... </ad>
<ad> .... </ad>
</sercanto>

Sercanto  Srl
Via Calzabigi, 4,
57125 Livorno LI – Italy
phone +39 0586 404377

Scroll to Top