Πρόσθεσε τις αγγελίες σου στο CityList Σπίτι

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

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

We just need an XML feed of your real estate advertisements 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 advertisements.
Making an XML feed for real estate 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:

  1. read through the XML file specifications and then compare with the suggested example;
  2. 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";
  3. to verify if the individual XML file you have generated works properly please use our on-line validator;
  4. Inform us using this form that the XML feed for real estate advertisements has been completed;
  5. ... Very shortly your real estate ads will be indexed and available for search by the thousands of users of CityList Jobs.

XML Feed Specifications of CityList Real Estate

Carefully read the XML Feed specifications 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 encoding must 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 Real Estate. Obligatory.
feed/versionThe version number of XML Feed of CityList Real Estate: currently 1.0. Obligatory.
feed/infoThe node contains all the information relating to the specific feed. Obligatory.
feed/info/publisherInformation relating to the publisher. Obligatory.
feed/info/publisher/nameThe name of the publisher. Example: "Real Estate 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 of the programme that generates the feed itself) formatted like so: RFC 2822. Example: "Mon, 22 Apr 2019 22:11:25 +0200" Obligatory.
feed/info/engineWork for this value is always "realestate". Obligatory.
feed/info/multipageThis 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-urlThe node contains the base URL of the feed without the parameter that controls the required page number. Obligatory if 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 multipage.
feed/info/multipage/pagesThe pages node contains information on the current page and on the last page available. Obligatory if multipage.
feed/info/multipage/pages/currentThis 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/lastThis node contains the number of the last feed page. CityList Real Estate will run through all the pages from 1 to the number in this parameter. Obligatory if multipage.
feed/itemsThe 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 specity 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/metadataThis macro-node contains descriptive information of the advertisement. Obligatory.
feed/items/item/metadata/unique-referenceThis 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/urlThe 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-publishingDate 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-expirationDate 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/locationThis macro-node contains information relative to the locations of the property. Obligatory.
feed/items/item/metadata/location/addressFull address in the form "Street name and number, Zip code, City, State, 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 (Zip) Code
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 this real estate.
feed/items/item/metadata/contact/advertiserThe advertiser that sells or rents real estate.
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. This node may be repeated more than once to indicate more telephone numbers.
feed/items/item/transaction-typeSale or rental. Admitted values are:
  • S: for Sale;
  • R: for Rent.
Obligatory.
feed/items/item/categoryCommercial or Residential. Admitted values are:
  • C: Commercial;
  • R: Residential.
Obligatory.
feed/items/item/property-typeReal 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/roomsTotal room count.
feed/items/item/bedroomsNumber of bedrooms.
feed/items/item/bathroomsNumber of bathrooms.
feed/items/item/size[@unit]Property size and measuring unit. Value of attribute unit can be:
  • m2: square meters;
  • sq_ft: square feet;
  • ac: acre;
feed/items/item/price[@currency]Real estate price. The @currency attribute should be filled with the currency in the ISO 4217 format. Example: "USD".
feed/items/item/descriptionDetailed and complete text of the real estate description. May not contain HTML tags 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 real estate images. This node may contain several sub-nodes of type picture-url in the event of more property images.
feed/items/item/pictures/picture-urlURL of photo. JPG is the admitted format. Obligatory if there is a pictures macro-node.

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 inform the staff of CityList Real Estate about an XML feed of real estate ads.

Contact email:
XML feed address (URL):
Brief description:
(προαιρετικό)