Add your ads to CityList Cars/Bikes

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

Do you have a website that publishes cars and motorbikes 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 cars and motorbikes?

We just need an XML feed of your job announcements 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 announcements.
To make an XML feed for car and motorbike 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:

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

XML Feed Specific of CityList Cars/Bikes

Carefully read the XML Feed specific 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 encodingmust be UTF-8; of course the textual content must be encoded in UTF-8. Obligatory.
feedThis is root node and contains the XML Feed of CityList Cars/Bikes. Obligatory.
feed/versionThe version number of XML Feed of CityList Cars/Bikes: actually is 1.0. Obligatory.
feed/infoThe node contains all the information relating to specific feed. Obligatory.
feed/info/publisherInformation relating to the publisher. Obligatory.
feed/info/publisher/nameThe name of the publisher. Example: "Sale Cars Inc.". Obligatory.
feed/info/publisher/siteThe publisher web site. Example: "http://www.example.com/". Obligatory.
feed/info/publisher/emailPublisher's XML Feed Mail address. Example: "info@example.com". Obligatory.
feed/info/build-dateXML Feed build date (not to the realization of the programme that generates the feed itself) in format RFC 2822. Example: "Fri, 09 Jan 2009 03:07:44 +0100" Obligatory.
feed/info/engineWork for this value is always "car". Obligatory.
feed/info/multipageThis 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-urlThe node contains the base URL of feed without the parameter that controls the page number required. Obligatory if this multipage.
feed/info/multipage/page-paramThis 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/pagesThe pages node contains information on the current page and to the last page available. Obligatory if this multipage.
feed/info/multipage/pages/currentThis 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/lastThis 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/itemsThe 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/metadataThis macro-node contains descriptive information of the announcement Obligatory.
feed/items/item/metadata/unique-referenceThis 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/urlThe 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-publishingDate 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-expirationDate 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/locationThis macro-node contains information relative to the locations of this car or motorbike. Obligatory.
feed/items/item/metadata/location/addressFull address in the form "Name road, number, Zip code, City, USA".
feed/items/item/metadata/location/country-codeNation code in ISO 3166 (Alpha 2) format. Obligatory.
feed/items/item/metadata/location/administrative-areaThe Administrative Area relative to location.
feed/items/item/metadata/location/sub-administrative-areaThe Sub-Administrative Area relative to location.
feed/items/item/metadata/location/localityThe City (locality) relative to location.
feed/items/item/metadata/location/thoroughfareThe thoroughfare relative to location.
feed/items/item/metadata/location/postal-code-numberPostal Code Number
feed/items/item/metadata/location/longitudeThe exact longitude relative to location (in the interval +180/-180 to referer 180° EAST/180° WEST)
feed/items/item/metadata/location/latitudeThe exact latitude relative to location (in the interval +90/-90 to referer 90° NORD/90° SUD)
feed/items/item/metadata/contactThis macro-node contains information related to contacts of job offer.
feed/items/item/metadata/contact/advertiserThe advertiser that sell this car or motorbike.
feed/items/item/metadata/contact/emailEmail address of feed/items/item/metadata/contact/advertiser.
feed/items/item/metadata/contact/phone-numberTelephone 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/makeMake (brand) of car or motorbike. Example: "Nissan". Obligatory.
feed/items/item/modelModel of car or motorbike. Example: "Altima". Obligatory.
feed/items/item/conditionThe car or motorbike is new or used? Admitted values are:
  • N: New car or motorbike;
  • U: Used car or motorbike.
Obligatory.
feed/items/item/car-typeCar 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/yearYear 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-colorThe exterior color of car or motorbike. Example: "Red".
feed/items/item/interior-colorThe interior 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 centimeter;
  • in3: cubic inch.
  • L: liters.
feed/items/item/fuel-typeThe fuel type. Value must be in:
  • gasoline (alias: unleaded)
  • diesel (alias: gas oil)
  • gas (alias: lpg)
  • methane
  • electric
  • hydrogen
  • mixture
  • grain alcohol (alias: ethanol)
This node can be multiple: can be specified more than one fuel type but every type in a sigle node fuel-type.
feed/items/item/doorsThe dors of car.
feed/items/item/transmission-gearThe transmission gear. Value must be in::
  • A: automatic gear;
  • M: manual gear.
feed/items/item/emission-standardThe emission standard. Values must be in:
  • EURO 1
  • EURO 2
  • EURO 3
  • EURO 4
feed/items/item/price[@currency]The car or motorbike price. In attribute @currency must be specified che currency used in ISO 4217 format. Example: "USD".
feed/items/item/descriptionDetailed and complete text of car or motorbike 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/picturesThis macro-node contains URLS to car or motorbike images. This node can contains more sub-nodes of type picture-url in the event of more car images.
feed/items/item/pictures/picture-urlURL of photo. Are admitted images in JPG format. Obligatory if this pictures.

Example XML Feed

Form to validate the XML Feed.

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

Feed XML address (URL):

Form to submit a new XML Feed

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

XML Feed address (URL):
Short description:
(optional)