CityList.gr

Add your advertisements from your website to the search results of CityList Cars/Bikes

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

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

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 car and motorbike advertisements.
Making an XML feed for car and motorbike advertisements 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 through the XML file specifications and then compare with the suggested example;
using your programming language of choice you can set up a small program which pulls out ads from your database, and then formats them according to the specifications at the "point 1";
to verify if the individual XML file you have generated works properly please use our on-line validator;
Inform us using this form that the XML feed for car and bike advertisements has been completed;
... Very shortly your car and bike ads will be indexed and available for search by the thousands of users of CityList Jobs.

XML Feed Specifications of CityList Cars/Bikes

Carefully read the XML Feed specifications described below.
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE feed SYSTEM "http://www.verthink.com/dtd/car-1.0.dtd"> XML file header. The encoding must 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 Cars/Bikes. Obligatory.
feed/version The version number of XML Feed of CityList Cars/Bikes: currently 1.0. Obligatory.
feed/info The node contains all the information relating to the specific feed. Obligatory.
feed/info/publisher Information relating to the publisher. Obligatory.
feed/info/publisher/name The name of the publisher. Example: "Sale Cars 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 of the programme that generates the feed itself) formatted like so: RFC 2822. Example: "Thu, 21 Feb 2019 09:29:57 +0100" Obligatory.
feed/info/engine For CityList Cars/Bikes this value is always "car". Obligatory.
feed/info/multipage This macro-node contains information relating to multipage feeds where the number of advertisements is very high. An XML Feed can in fact be divided into several pages of smaller sizes. Is recommended not to exceed, for a single feed, about 1.000 ads.
feed/info/multipage/base-url The node contains the base URL of the feed without the parameter that controls the required page number. Obligatory if 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 multipage.
feed/info/multipage/pages The pages node contains information on the current page and on the last page available. Obligatory if multipage.
feed/info/multipage/pages/current This node contains the feed page number currently generated (must be equal to the value of the parameter page-param the GET request sent or to the value "1" if the request has been carried out without specifying any parameter). The request which comes next will be made with this value increased by 1 (up to the value of the nodelast, included). Obligatory if multipage.
feed/info/multipage/pages/last This node contains the number of the last feed page. CityList Cars/Bikes will run through all the pages from 1 to the number in this parameter. Obligatory if multipage.
feed/items The items node contains the number of all ads inside item nodes. Obligatory.
feed/items/item[@kind] The item node contains information related to a single ad.
It's obligatory to specify an attribute kind that can be one of these values:
new : all obligatory nodes must be specified; ad is treated as new and is indexed;
deleted : ad 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 advertisement. Obligatory.
feed/items/item/metadata/unique-reference This is the most important node of the macro-node metadata: it contains the identifier of the advertisement.
We use this identifier to refer to the inserted advertisement. If the identifier exists already in our indices (for the same publisher/name) it 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 advertisement. 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 advertisement on the site of the publisher (for the specification of the date format see feed/info/build-date). Obligatory.
feed/items/item/metadata/date-expiration Date of expiry of the advertisement. After this date the advertisement might be removed from our indices (for the specification for the date format see feed/info/build-date).
feed/items/item/metadata/location This macro-node contains information relative to the locations of this car or motorbike. Obligatory.
feed/items/item/metadata/location/address Full address in the form "Street name and number, Zip code, City, State, 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 (Zip) Code
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 this car or bike.
feed/items/item/metadata/contact/advertiser The advertiser that sells this car or motorbike.
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. This node may be repeated more than once to indicate more telephone numbers.
feed/items/item/make Make (brand) of car or motorbike. Example: "Nissan". Obligatory.
feed/items/item/model Model of car or motorbike. Example: "Altima". Obligatory.
feed/items/item/condition New or used? Admitted values are:
N: New car or motorbike;
U: Used car or motorbike.
Obligatory.
feed/items/item/car-type Car or motorbike type. Admitted values are:
car
sedan
convertible
compact car
coupe
sport utility
station wagon
minivan
hatchback
commercial vehicles
vintage car
race car
motorbike
bus
caravan
trucks
Obligatory.
feed/items/item/year Year of registration of car or motorbike.
feed/items/item/mileage[@unit] Car or motorbike mileage. Attribute unit must be in:
km: kilometers;
miles: miles.
feed/items/item/exterior-color The exterior main color of car or motorbike. Example: "Red".
feed/items/item/interior-color The interior main color of car. Example: "Gray".
feed/items/item/engine-power[@unit] The engine power. Attribute value unit must be in:
horsepower: horse power;
kilowatt: kilowatt.
feed/items/item/engine-displacement[@unit] The engine displacement. Attribute value unit must be in:
cm3: cubic centimeters;
in3: cubic inches.
L: liters.
feed/items/item/fuel-type The fuel type. Value must be:
gasoline (alias: unleaded)
diesel (alias: gas oil)
gas (alias: lpg)
methane
electric
hydrogen
mixture
grain alcohol (alias: ethanol)
This node can be multiple: more than one fuel type may be specified, but each type in its own single fuel-type node.
feed/items/item/doors The doors of the car (zero if motorbike).
feed/items/item/transmission-gear The gear shift transmission. Value must be:
A: automatic gear;
M: manual gear.
feed/items/item/emission-standard The emission standard. Values may be:
BIN 1
LEV
EURO 4
...
feed/items/item/price[@currency] The car or motorbike price. @Currency must be specified in ISO 4217 format. Example: "USD".
feed/items/item/description Detailed and complete text of the car or motorbike description. May not contain HTML tags and must be obviously coded in UTF-8. This text must not be truncated or shortened.
feed/items/item/pictures This macro-node contains URLs to car or motorbike images. This node may contain several sub-nodes of type picture-url in the event of more vehicle images.
feed/items/item/pictures/picture-url URL of photo. JPG is the admitted format. Obligatory if there is a pictures macro-node.

Example XML Feed

<?xml version="1.0" encoding="UTF-8" ?> <!DOCTYPE feed SYSTEM "http://www.verthink.com/dtd/car-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>car</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/cardetail?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>Shirlington</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> <make>Nissan</make> <model>Almera</model> <condition>U</condition> <car-type>car</car-type> <year>1999</year> <mileage unit="miles" >100000</mileage> <exterior-color>Red</exterior-color> <interior-color>Gray</interior-color> <engine-power unit="horsepower">70</engine-power> <engine-displacement unit="cm3">1300</engine-displacement> <fuel-type>unleaded</fuel-type> <fuel-type>lpg</fuel-type> <doors>5</doors> <transmission-gear>M</transmission-gear> <emission-standard>EURO 3</emission-standard> <price currency="USD">7000</price> <description>Good veicle. Air conditioning, airbag.</description> <pictures> <picture-url>http://www.example.com/image/car/Z9A8B43/img.png</picture-url> </pictures> </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 inform the staff of CityList Cars and Bikes about an XML feed of cars and bikes ads.