Tus anuncios en Trovit España

Feed Casas

Actualizado: 7 Julio 2011

Si tienes una página web con anuncios publicados, ¡puedes incluir tus anuncios en Trovit!. Es muy sencillo:

  1. Crea un archivo XML siguiendo el formato especificado más abajo.
  2. Descarga nuestro Validador de XML y comprueba que el archivo está bien construido. Esta validación del XML es importante para que la indexación de tu contenido sea correcta.
  3. Envía la URL donde se aloja (Ejemplo: http://www.tudominio.com/trovit_feed.xml) a través de nuestro formulario de contacto.

A partir de ese momento, leeremos el feed periódicamente para insertar anuncios nuevos, realizar las modificaciones pertinentes y caducar aquellos anuncios que ya no estén presentes en tu feed.

Tus anuncios serán introducidos en los resultados de búsqueda de Trovit lo antes posible.

Si tienes alguna consulta no dudes en ponerte en contacto con nosotros

Formato del feed XML

Estas son las instrucciones para generar un feed XML con el fin de incluir tus anuncios en Trovit. Si necesitas más información sobre el formato XML te aconsejamos que consultes la Wikipedia.

La codificación del archivo debe ser en UTF-8.

El archivo XML contendrá un etiqueta principal <trovit> que recogerá un conjunto de anuncios representado por bloques de etiquetas <ad></ad>. Cada bloque <ad></ad> contiene campos obligatorios y opcionales:

Campos obligatorios

Los campos obligatorios son el conjunto de etiquetas XML que proporcionan la cantidad mínima de información necesaria para que nuestros sistemas incluyan tus anuncios en Trovit.

  • id: Identificador del anuncio en tu página web (puede ser numérico o alfanumérico, pero debe ser único, ya que lo utilizamos para evitar anuncios duplicados).
  • url: URL del anuncio en tu página web.
  • title: Título del anuncio.
  • type: Tipo de anuncio. El contenido de este campo debe ser uno de los siguientes:
    • “For Rent”: Alquiler de inmueble a largo plazo
    • “For Sale”: Venta de inmueble
    • “Roommate”: Compartir piso
    • “Parking For Rent”: Alquiler de parking
    • “Parking For Sale”: Venta de parking
    • “Office For Rent”: Alquiler de oficina
    • “Office For Sale”: Venta de oficina
    • “Land For Sale”: Terrenos
    • “For Rent Local”: Alquiler de local
    • “For Sale Local”: Venta de local
    • “Transfer Local”: Traspaso de local
    • “Country House Rentals”: Alquiler rural
    • “Warehouse For Rent”: Alquiler de nave
    • “Warehouse For Sale”: Venta de nave
  • content: Descripción del anuncio (mínimo de 30 caracteres). Recuerda que cuanto más rica sea la descripción, ¡mayor será tu audiencia!

Campos opcionales

Los campos opcionales no deben añadirse si no tienen contenido. Pero si dispones de estos campos en tu página web, no dudes en incluirlos en tu feed. El algoritmo de ordenación de Trovit prioriza la calidad, y cuanto más rico sea el anuncio, ¡mejor será tu posicionamiento!

  • price: Precio del inmueble. Se puede indicar el periodo (monthly, daily o weekly) como atributo dentro de esta etiqueta. 
    <price period="weekly"><![CDATA[...]]></price>

    Dependiendo de la tipología del anuncio, a veces no es necesario aplicarlo.

    Cuando el precio esté especificado en una moneda que no es la divisa oficial del país, se deberá usar el atributo ‘currency’. Los valores vendrán determinados por la norma ISO-4217. De este modo, Trovit podrá realizar la conversión a la moneda oficial.

    El periodo por defecto es mensual, pero también se puede indicar el periodo semanal. La sintaxis sería la siguiente:

    <price period="weekly" currency="USD"><![CDATA[...]]></price>

    Esto especificaría el precio semanal, en dólares. No se debe incluir el símbolo de la moneda junto al precio.

  • property_type: Tipo de propiedad (por ejemplo: piso, casa, estudio, chalé, ático, etc.). Sólo aplicable si el anuncio es de tipo “For Rent”, “For Sale”.
  • address: Dirección donde se encuentra el bien inmobiliario.
  • floor_number: Información textual con el número de planta del bien inmobiliario.
  • neighborhood : Barrio donde se encuentra el bien inmobiliario.
  • city_area: Área de la ciudad donde se encuentra el bien inmobiliario.
  • city: Ciudad donde se encuentra el bien inmobiliario.
  • region: Nombre de la provincia donde se encuentra el bien inmobiliario.
  • postcode: Código postal.
  • latitude: Latitud donde se encuentra el bien inmobiliario. Ver especificaciones técnicas para más detalles.
  • longitude: Longitud donde se encuentra el bien inmobiliario. Ver especificaciones técnicas para más detalles.
  • orientation: Información textual sobre la orientación del alojamiento (norte, sur, este, oeste, etc.).
  • agency: Nombre de la agencia. Ver campo by_owner para más información.
  • mls_database: Identificador único asignado a cada bien inmobiliario de una base de datos MLS (Multiple Listing Service).
  • floor_area: Superficie del bien inmobiliario. Si no se especifica la unidad de medida se tomará la medida local por defecto. Podemos especificar la unidad de medida con el atributo ‘unit’: 
    <floor_area unit="feet"><![CDATA[...]]></floor_area>

    Los valores de ‘unit’ disponibles son: “meters” o “feet”.

  • plot_area: Superficie de la parcela dónde se ubica el bien inmobiliario. Si no se especifica la unidad de medida se tomará la medida local por defecto. Podemos especificar la unidad de medida con el atributo ‘unit’: 
    <plot_area unit="hectares"><![CDATA[...]]></plot_area>

    Los valores de ‘unit’ disponibles son: “meters”, “feet”, “acres” o “hectares”.

  • rooms: Número de habitaciones del bien inmobiliario.
  • bathrooms: Número de baños del bien inmobiliario.
  • condition: Información textual sobre el esto del bien inmobiliario (por ejemplo: reformado recientemente).
  • year: Año de construcción del bien inmobiliario. El formato aceptado es AAAA.
  • virtual_tour: URL dónde se puede encontrar un paseo virtual del bien inmobiliario.
  • pictures: Esta etiqueta engloba las distintas imágenes del bien inmobiliario.
    El campo que define una imagen en particular es <picture>:

    • picture: Esta etiqueta engloba los campos para especificar la URL y el título de la imagen (este último opcional).
      Los campos a definir dentro del elemento <picture> son:

      • picture_url: URL de la imagen.
      • picture_title: Título de la imagen.
    <pictures>
<picture>
    <picture_url><![CDATA[...]]></picture_url>
    <picture_title><![CDATA[...]]>/picture_title>
</picture>

<picture>
    <picture_url><![CDATA[...]]></picture_url>
    <picture_title><![CDATA[...]]>/picture_title>
</picture>
    ...
</pictures>

    La imagen mostrada en Trovit de un anuncio en particular será la primera del conjunto de imágenes del anuncio.

    Escoge la imagen más adecuada ya que ésta tiene una gran influencia sobre los clics del usuario.

    Trovit no permite la inclusión de fotos corporativas con el mensaje “Imagen no disponible”.

    Si se detectara este caso, Trovit se reserva el derecho de bloquear tus anuncios.

    Una vez se inserten tus anuncios en Trovit, las imágenes asociadas a los anuncios no se podrán modificar ni tan siquiera en la siguiente lectura de tu feed.

    Asegúrate que los nuevos anuncios que añadas a tu feed incluyen las imágenes correctas.

  • date: Fecha de publicación del anuncio. El formato aceptado es DD/MM/AAAA o DD/MM/AAAA HH:MM:SS.
  • expiration_date: Fecha en la que caducará el anuncio. El formato aceptado es DD/MM/AAAA.

Los siguientes campos deben rellenarse según si son ciertos o falsos. Ver especificaciones técnicas para saber que valores representan cierto y que valores falso.

  • by_owner: Si el bien inmobiliaro es ofrecido por un particular. En caso de ser falso se entenderá que es ofrecido por una agencia.
  • parking: Si el bien inmobiliario tiene parking o no.
  • foreclosure: Si el bien inmobiliario está bajo subasta por embargo.
  • is_furnished: Si el bien inmobiliario está amueblado o no.
  • is_new: Si el bien inmobiliario es de nueva construcción o no.

El feed XML quedará así:

<?xml version="1.0" encoding="utf-8"?>
<trovit>

<ad>
<id><![CDATA[...]]></id>
<url><![CDATA[...]]></url>
<title><![CDATA[...]]></title>
<type><![CDATA[...]]></type>
<content><![CDATA[...]]></content>

<price><![CDATA[...]]></price>
<property_type><![CDATA[...]]></property_type>

<address><![CDATA[...]]></address>
<city_area><![CDATA[...]]></city_area>
<city><![CDATA[...]]></city>
<region><![CDATA[...]]></region>
<postcode><![CDATA[...]]></postcode>
<latitude><![CDATA[...]]></latitude>
<longitude><![CDATA[...]]></longitude>
<agency><![CDATA[...]]></agency>

<floor_area unit="feet"><![CDATA[...]]></floor_area>
<rooms><![CDATA[...]]></rooms>
<bathrooms><![CDATA[...]]></bathrooms>
<virtual_tour><![CDATA[...]]></virtual_tour>
<parking><![CDATA[...]]></parking>

<pictures>

    <picture>
        <picture_url><![CDATA[...]]></picture_url>
        <picture_title><![CDATA[...]]></picture_title>
    </picture>
    <picture>

        <picture_url><![CDATA[...]]></picture_url>
        <picture_title><![CDATA[...]]></picture_title>
    </picture>
    ...
</pictures>

<date><![CDATA[...]]></date>

</ad>

<ad>
....
</ad>

<ad>
....
</ad>

...

</trovit>

Ejemplo de feed XML

<?xml version="1.0" encoding="utf-8"?>
<trovit>
<ad>
<id><![CDATA[7004578]]></id>
<url><![CDATA[http://www.tupaginaweb.es/ad/7004578]]></url>
<title><![CDATA[Piso 2 habitaciones en Clot, Barcelona]]></title>
<type><![CDATA[For rent]]></type>
<content><![CDATA[Piso 2 habitaciones en Clot, Barcelona ]]></content>

<price><![CDATA[800]]></price>
<property_type><![CDATA[Piso]]></property_type>

<address><![CDATA[Av. Meridiana]]></address>
<city_area><![CDATA[Clot]]></city_area>
<city><![CDATA[Barcelona]]></city>
<region><![CDATA[Barcelona]]></region>
<postcode><![CDATA[08018]]></postcode>
<latitude><![CDATA[41.409583]]></latitude>
<longitude><![CDATA[2.187223]]></longitude>
<agency><![CDATA[Agencia Inmobiliaria]]></agency>

<floor_area unit="meters"><![CDATA[100]]></floor_area>
<rooms><![CDATA[2]]></rooms>
<bathrooms><![CDATA[1]]></bathrooms>
<parking><![CDATA[0]]></parking>

<pictures>
    <picture>
        <picture_url><![CDATA[http://www.tudominio.es/image.jpg]]></picture_url>
        <picture_title><![CDATA[salón]]></picture_title>
    </picture>
</pictures>

<date><![CDATA[01/01/2011 18:30]]></date> </ad>

<ad>
<id><![CDATA[332A53BC2]]></id>
<url><![CDATA[http://www.tupaginaweb.es/ad/332A53BC2]]></url>
<title><![CDATA[Piso nuevo en Sevilla]]></title>
<type><![CDATA[For sale]]></type>
<content><![CDATA[Piso nuevo, tercera planta, muy céntrico]]></content>

<price><![CDATA[209950]]></price>

<address><![CDATA[]]></address>
<city><![CDATA[Sevilla]]></city>
<region><![CDATA[Sevilla]]></region>
<postcode><![CDATA[]]></postcode>

<pictures>
    <picture>
        <picture_url><![CDATA[http://www.tudominio.es/image.jpg]]></picture_url>
        <picture_title><![CDATA[salón]]></picture_title>
    </picture>
</pictures>

<date><![CDATA[01/01/2010 17:30]]></date>
</ad>
</trovit>

Especificaciones Técnicas

Para más información, haga click aquí: ver especificaciones técnicas.