CityList.com

Add your announcements from your website to the search results of CityList Jobs

Do you have a website that publishes job announcements?
Would you like to increase visits to your website and receive quality traffic for free?
You want to know or record your brand for users that are looking for jobs?

We just need an XML feed of your job announcements and shortly these will visible within the search results for CityList Jobs.

What is an XML Feed?

An XML feed is a simple text file with specific formatting (XML) that contains its own structured information of your job announcements.
To make an XML feed for job announcements is simple to do using any programming language, even the one which runs your web site.

How does it work?

Follow these steps to set up an XML feed:

read the XML file specific and then compare example proposed;
through your preferred programming language you can set up a small program from your database of job announcements, and the show according to the specific at the "point 1";
to verify if the specific XML file you have generated works properly please use our on-line validator;
Inform us using this module that the XML feed for job announcements has been completed;
... Very shortly your job announcements will be indexed and available for search by the thousands of users on CityList Jobs.

XML Feed Specific of CityList Jobs

Carefully read the XML Feed specific described below.
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE feed SYSTEM "http://www.verthink.com/dtd/job-1.0.dtd"> XML file header. The encodingmust be UTF-8; of course the textual content must be encoded in UTF-8. Obligatory.
feed This is root node and contains the XML Feed of CityList Jobs. Obligatory.
feed/version The version number of XML Feed of CityList Jobs: actually is 1.0. Obligatory.
feed/info The node contains all the information relating to specific feed. Obligatory.
feed/info/publisher Information relating to the publisher. Obligatory.
feed/info/publisher/name The name of the publisher. Example: "Temporary Work Inc.". Obligatory.
feed/info/publisher/site The publisher web site. Example: "http://www.example.com/". Obligatory.
feed/info/publisher/email Publisher's XML Feed Mail address. Example: "info@example.com". Obligatory.
feed/info/build-date XML Feed build date (not to the realization of the programme that generates the feed itself) in format RFC 2822. Example: "Fri, 09 Jan 2009 01:40:22 +0100" Obligatory.
feed/info/engine Work for this value is always "job". Obligatory.
feed/info/multipage This macro-node contains information relating to feed multipage where the number of announcements was very high. An XML Feed can in fact be divided into more seen feed of smaller sizes. Is recommended not to overcome, for a single feed, about 1.000 ads.
feed/info/multipage/base-url The node contains the base URL of feed without the parameter that controls the page number required. Obligatory if this multipage.
feed/info/multipage/page-param This node contains the name of the parameter to add to the URL in the format "?param_name=value" (HTTP GET request only). Obligatory if this multipage.
feed/info/multipage/pages The pages node contains information on the current page and to the last page available. Obligatory if this multipage.
feed/info/multipage/pages/current This node contains the page of feed currently generated (must be equal to the value of the parameter page-param the request GET sent or the value "1" if the request has been carried out without specifying any parameter). The request will be next; made with this value increased by a unit be (up to the value of the nodelast, included). Obligatory if this multipage.
feed/info/multipage/pages/last This node contains the number of the last page of feed. Work will be all pages from 1 to number in this parameter Obligatory if this multipage.
feed/items The items node contains all ads inside item nodes. Obligatory.
feed/items/item[@kind] The item node contains information related to a single ads.
It's obligatory to specity attribute kind that can be one of this values:
new : all obligatory node must be specified; ads is treated as new and is indexed;
deleted : ads is deleted from index. The only node that is obligatory to specify is unique-reference.
Obligatory tag and attribute @kind.
feed/items/item/metadata This macro-node contains descriptive information of the announcement Obligatory.
feed/items/item/metadata/unique-reference This is the node more important of the macro-node metadata: it contains the identifier the announcement.
We use this identifier to refer to the announcement inserted. If the identifier exists already be in our indices (for the same publisher/name) will be discarded (if you run an operation[@kind = "new"]) or deleted (if you run an operation[@kind = "deleted"]). Obligatory.
feed/items/item/metadata/url The node contains the URL of this announcement. This address will be used in the pages of the results to lead the user to the display of the advertisement on the site of the publisher. Obligatory.
feed/items/item/metadata/date-publishing Date of publication of the announcement on the site of the publisher (for the specification for the date format compare feed/info/build-date). Obligatory.
feed/items/item/metadata/date-expiration Date of expire of the announcement. After this date announcement could be deleted from our indexes (for the specification for the date format compare feed/info/build-date).
feed/items/item/metadata/location This macro-node contains information relative to the locations of work place. Obligatory.
feed/items/item/metadata/location/address Full address in the form "Name road, number, Zip code, City, USA".
feed/items/item/metadata/location/country-code Nation code in ISO 3166 (Alpha 2) format. Obligatory.
feed/items/item/metadata/location/administrative-area The Administrative Area relative to location.
feed/items/item/metadata/location/sub-administrative-area The Sub-Administrative Area relative to location.
feed/items/item/metadata/location/locality The City (locality) relative to location.
feed/items/item/metadata/location/thoroughfare The thoroughfare relative to location.
feed/items/item/metadata/location/postal-code-number Postal Code Number
feed/items/item/metadata/location/longitude The exact longitude relative to location (in the interval +180/-180 to referer 180° EAST/180° WEST)
feed/items/item/metadata/location/latitude The exact latitude relative to location (in the interval +90/-90 to referer 90° NORD/90° SUD)
feed/items/item/metadata/contact This macro-node contains information related to contacts of job offer.
feed/items/item/metadata/contact/advertiser The advertiser that offers work.
feed/items/item/metadata/contact/email Email address of feed/items/item/metadata/contact/advertiser.
feed/items/item/metadata/contact/phone-number Telephone number of feed/items/item/metadata/contact/advertiser. It's possible to repeat more times this node to indicate more telephone numbers.
feed/items/item/position La posizione da ricoprire a cui fa riferimento l'offerta di lavoro. Esempio: "Ingegnere Edile", "Segretaria di Direzione", ... Obbligatorio.
feed/items/item/company L'Azienda che ha aperto la specifica posizione (potrebbe essere uguale a feed/items/item/metadata/contact/advertiser qualora advertiser non sia una agenzia per il lavoro).
feed/items/item/description Detailed and complete text of job offer description. Can't contains HTML tag and must be obviously coded in UTF-8. This text must not be truncated or shorted.
feed/items/item/salary[@currency] The salary for the workers (gross, annual). In the attribute @currency must be specified the currency in ISO 4217 format. Example: "USD".
feed/items/item/education The title of study required to perform the task. Example: "Laureato in Ingegneria Elettronica", "Diploma di Perito Elettrotecnico", ...
feed/items/item/jobtype The type of job for this list:
fulltime : occupazione a tempo pieno;
parttime : employment of half a day or at least not full time.
feed/items/item/skills Know-how required to this job offer, max age, auto-munito. Example: "Experience of 10 years in the field, maximum 40 years old..."

Example XML Feed

<?xml version="1.0" encoding="UTF-8" ?> <!DOCTYPE feed SYSTEM "http://www.verthink.com/dtd/job-1.0.dtd"> <feed> <version>1.0</version> <info> <publisher> <name>Example Publisher</name> <site>http://www.example.com/</site> <email>info@example.com</email> </publisher> <build-date>Mon, 14 May 2007 16:00:09 +0200</build-date> <engine>job</engine> <multipage> <base-url>http://www.example.com/citylist-feed.php</base-url> <page-param>page</page-param> <pages> <current>1</current> <last>10</last> </pages> </multipage> </info> <items> <item kind="new"> <metadata> <unique-reference>Z9A8B43</unique-reference> <url>http://www.example.com/job/geometrician/ID-Z9A8B43</url> <date-publishing>Sun, 13 May 2007 12:30:00 +0200</date-publishing> <date-expiration>Wed, 15 Aug 2007 12:30:00 +0200</date-expiration> <location> <address>1903 N Lynn St, Arlington, VA 22209, USA</address> <country-code>US</country-code> <administrative-area>Virginia</administrative-area> <sub-administrative-area>Arlington</sub-administrative-area> <locality>Arlington</locality> <thoroughfare>1903 N Lynn St</thoroughfare> <postal-code-number>22209</postal-code-number> <longitude>-77.0708</longitude> <latitude>38.8975</latitude> </location> <contact> <advertiser>Example, Inc.</advertiser> <email>info@example.com</email> <phone-number>0123456789</phone-number> </contact> </metadata> <position>Geometrician</position> <company>Geometrician & Co.</company> <description>Geometri S.r.l. ricerca per prestigiosa azienda cliente con sede a Pienza (SI) una giovane risorsa in possesso del diploma di Geometra da inserire immediatamente con contratto di somministrazione a scopo successiva assunzione diretta. La risorsa selezionata seguirà number of shipyards in road construction scattered on the territory, mostly in the province of Siena and Perugia</description> <salary currency="USD">17160</salary> <education>Geometrician Diploma</education> <jobtype>fulltime</jobtype> <skills>Previous experience preferably in the field of road construction. Max age 30 years old.</skills> </item> <item kind="deleted"> <metadata> <unique-reference>W8B8B11</unique-reference> </metadata> </item> </items> </feed>

Form to validate the XML Feed.

Use this for to submit to validation test your XML Feed.

Form to submit a new XML Feed

Use this form to submit to CityList staff the address of your XML Feed.