CityList.com

Add your announcements from your website to the search results of CityList Real Estate

Do you have a website that publishes real estate 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 real estate?

We just need an XML feed of your real estate announcements and shortly these will visible within the search results for CityList Real Estate.

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 real estate announcements.
To make an XML feed for real estate 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 real estate 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 real estate announcements has been completed;
... Very shortly your job announcements will be indexed and available for search by the thousands of users on CityList Real Estate.

XML Feed Specific of CityList Real Estate

Carefully read the XML Feed specific described below.
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE feed SYSTEM "http://www.verthink.com/dtd/realestate-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 Real Estate. Obligatory.
feed/version The version number of XML Feed of CityList Real Estate: 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: "Real Estate 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 03:06:30 +0100" Obligatory.
feed/info/engine Work for this value is always "realestate". 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 real estate. 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 this real estate.
feed/items/item/metadata/contact/advertiser The advertiser that sell or rent real estate.
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/transaction-type Sell or rent. Admitted values are:
S: for Sale;
R: for Rent.
Obligatory.
feed/items/item/category Commercial or Residencial. Admitted values are:
C: Commercial;
R: Residential.
Obligatory.
feed/items/item/property-type Real estate type. Admitted values are:
Apartments.
Apartment
Condo
Townhouse
Attic
Loft
Studio
Houses.
House/Home
Country house
Mountain home
Mobile home
Modular home
Single-family home
Multi-family home
Houseboat
Villa
Buildings.
Building
Mansion
Industrial building
Commercial building
Office building
Business facilities.
Business facility
Farm/Ranch
Co-op
Hotel
Office
Store
Workshop
Lands.
Land
Lot
Commercial land
Industrial land
Farm land
Holiday accomodations.
Holiday accomodation
Vacation Home
Lake Property
River Property
Beach Property
Waterfront
Room
Others.
Other
Room
Garage
Open space
Timeshare
Obligatory.
feed/items/item/rooms Total rooms number.
feed/items/item/bedrooms Bedrooms number.
feed/items/item/bathrooms Bathrooms number.
feed/items/item/size[@unit] Real estate size and unit. Value of attribute unit can be:
m2: metro quadrato;
sq_ft: square foot;
ac: acre;
feed/items/item/price[@currency] Real estate price. Nell'attributo @currency sarà specificata la valuta nel formato ISO 4217. Esempio: "EUR".
feed/items/item/description Detailed and complete text of real estate 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/pictures This macro-node contains URLS to real estate images. This node can contains more sub-nodes of type picture-url in the event of more real estate images.
feed/items/item/pictures/picture-url URL of photo. Are admitted images in JPG format. Obligatory if this pictures.

Example Feed XML

<?xml version="1.0" encoding="UTF-8" ?> <!DOCTYPE feed SYSTEM "http://www.verthink.com/dtd/realestate-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>realestate</engine> <multipage> <base-url>http://www.example.com/biglist-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/ads.asp?id=Z9A8B43</url> <date-publishing>Sun, 13 May 2007 12:30:00 +0200</date-publishing> <date-expiration>Wed, 14 May 2008 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> <phone-number>0241234567</phone-number> </contact> </metadata> <transaction-type>S</transaction-type> <category>R</category> <property-type>Condo</property-type> <rooms>1</rooms> <bedrooms>1</bedrooms> <bathrooms>1.5</bathrooms> <size unit="sq_ft">280</size> <price currency="USD">700000</price> <description>Spacious end unit condo in beautiful Brookfield Terrace! Great location with easy Interstate access and parks within walking distance. Exterior features beautiful landscaping, large driveway and attached 2.5 car garage. Interior features newly tiled floors in entryway, half-bath and kitchen, and new carpet in large open concept living room and dining room. Kitchen has new appliances, including ceramic flat top range.</description> <pictures> <picture-url>http://www.example.com/images/Z9A8B43/image1.jpg</picture-url> <picture-url>http://www.example.com/images/Z9A8B43/image2.jpg</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 submit to CityList staff the address of your XML Feed.