XML Feed Format

  • The XML document must be well-formed. You can check with the W3C Validation Service to verify.
  • The feed should be written in UTF-8.
  • The document root element is named <ads> and each ad is an <ad> element.

Required fields

id
Your internal ID for this ad (it must be unique, as we will use this field to track duplicates).
title
Title of the ad
content
Description of the development (minimum of 30 characters).
address
Street address and door number (or intersecting street, or aproximate door number).
region
Name of the region/state where the ad is located.
agency

Information about the listing agency. It must contain the following elements:

Required
id
Internal agency ID. It should be a unique number or string. Make sure this ID never changes for a specific agency, otherwise, the stats we collect over time for that agency will be lost.
name
Agency name
phone
Phone number
email
E-mail address where contact forms will be sent
Optional
address
Street address
city_area
City area / neighborhood
city
City
region
Region / state
country
Country
logo_url
URL of the agency logo

Optional fields

pictures

This element includes the distinct images of the development. Inside this element, there must be a picture element with the following fields:

Required
picture_url
Image URL
Optional
picture_title
Image title

You are able to specify if an image is featured with the attribute featured. It must contain a boolean value (true, false, 0 or 1). Only the first picture with the attribute will be selected for the main picture. If none of the pictures has the attribute, the first one will be selected. Choose an adequate image as this largely influences where the user clicks.

Example XML
<pictures>
  <picture featured="true">
    <picture_url><![CDATA[http://www.foo.com/123.jpg]]></picture_url>
    <picture_title><![CDATA[Front view of the X]]></picture_title>
  </picture>
  <picture>
    <picture_url><![CDATA[http://www.foo.com/124.jpg]]></picture_url>
    <picture_title><![CDATA[Rear view of the X]]></picture_title>
  </picture>
</pictures>
blueprints

This element includes the distinct blueprint images of the development. Inside this element, there must be a blueprint element with the same fields as the picture described above.

Example XML
<blueprints>
  <blueprint>
    <picture_url><![CDATA[http://www.foo.com/124b1.jpg]]></picture_url>
    <picture_title><![CDATA[Blueprint]]></picture_title>
  </blueprint>
</blueprints>
city_area
Name of the neighborhood or city area where the ad is located.
city
Name of the city where the ad is located.
postcode
Zipcode.
latitude
Latitude of the development (decimal, between -90.0 and 90.0).
longitude
Longitude of the development (decimal, between -180.0 and 180.0).
features

This element includes a list of features of the development. Contains one or more <feature> string elements. The element may have the attribute label to define key-value features, where the label is the key and the value of the <feature> tag is the value.

Example 1
<features>
  <feature><![CDATA[Kitchen]]></feature>
  <feature><![CDATA[Living]]></feature>
  <feature><![CDATA[Dining]]></feature>
</features>
Example 2
<features>
  <feature label="Kitchen"><![CDATA[yes]]></feature>
  <feature label="Status"><![CDATA[good]]></feature>
</features>
amenities

This element includes a list of amenities of the development. Contains one or more <amenity> string elements. The element may have the attribute label to define key-value features, where the label is the key and the value of the <amenity> tag is the value. Same format as the features tag

services

This element includes a list of services of the development. Contains one or more <service> string elements. The element may have the attribute label to define key-value features, where the label is the key and the value of the <service> tag is the value. Same format as the features tag

payment
Method of payment (string).

Example feed

<?xml version="1.0" encoding="utf-8"?>
<ads>
  <ad>
    <id><![CDATA[11aa]]></id>
    <title><![CDATA[Beautiful apartment, near the sky!]]></title>
    <content><![CDATA[lorem ipsum tower. this must be at least 30 chars long.]]></content>
    <address><![CDATA[Pepito St 3211]]></address>
    <region><![CDATA[Buenos Aires]]></region>
    <agency>
      <name><![CDATA[Inmo 123]]></name>
      <phone><![CDATA[011-444-4444]]></phone>
      <email><![CDATA[info@inmo123.com.ar]]></email>
      <address><![CDATA[Malabia 123]]></address>
      <city_area><![CDATA[Palermo]]></city_area>
      <city><![CDATA[Ciudad de Buenos Aires]]></city>
      <region><![CDATA[Ciudad de Buenos Aires]]></region>
      <country><![CDATA[Argentina]]></country>
      <logo_url><![CDATA[http://www.example.com/logos/logo.jpg]]></logo_url>
    </agency>
    <pictures>
      <picture>
        <picture_url><![CDATA[http://www.foo.com/11aa/123.jpg]]></picture_url>
        <picture_title><![CDATA[View from the pool X]]></picture_title>
      </picture>
    </pictures>
    <blueprints>
      <blueprint>
        <picture_url><![CDATA[http://www.foo.com/11aa/300.jpg]]></picture_url>
        <picture_title><![CDATA[Blueprint A]]></picture_title>
      </blueprint>
      <blueprint>
        <picture_url><![CDATA[http://www.foo.com/11aa/301.jpg]]></picture_url>
        <picture_title><![CDATA[Blueprint B]]></picture_title>
      </blueprint>
    </blueprints>
    <city_area><![CDATA[Belgrano]]></city_area>
    <city><![CDATA[Ciudad de Buenos Aires]]></city>
    <postcode><![CDATA[1412]]></postcode>
    <latitude><![CDATA[-34.58828009730246]]></latitude>
    <longitude><![CDATA[-58.42357635498047]]></longitude>
    <amenities>
      <amenity><![CDATA[Swimming Pool]]></amenity>
      <amenity><![CDATA[Spa]]></amenity>
      <amenity><![CDATA[Terrace with trees]]></amenity>
    </amenities>
    <services>
      <service><![CDATA[Electricity]]></service>
      <service><![CDATA[Water]]></service>
      <service><![CDATA[Natural Gas]]></service>
      <service><![CDATA[Sewage]]></service>
    </services>
    <payment>10% reserva. 20% al inicio del proyecto y el saldo en 18 cuotas en pesos.</payment>
  </ad>
</ads>