Os seus anúncios no Trovit Portugal

Feed Casas

Caso tenha um site de classificados, inclua seus anúncios no Trovit. É muito simples:

  1. Gere um arquivo XML no formato especificado abaixo para o vertical de Imóveis
  2. Envie o link no qual encontraremos o XML (Exemplo: http://www.yourdomain.com/wp_feed.xml) por meio do nosso email de contato.

A partir desse momento, nosso sistema revisará o feed periodicamente para inserir novos anúncios, realizar as modificações pertinentes e expirar os anúncios que já não estejam presentes no feed.

Seus anúncios serão inseridos nos resultados de pesquisas do Trovit o antes possível.

Importante: No Trovit Imóveis são indexados somente anúncios de venda e aluguel de residências particulares. Não devem ser incluidos no feed anúncios de pontos comerciais, terrenos, garagens, etc…

Em caso de dúvidas, entre em contacto conosco!

Formato do feed XML

Estas são as instruções para gerar um feed XML para a inclusão de anúncios no Trovit. Caso necessite mais informações sobre o formato XML, poderá consultar na Wikipedia.

A codificação do arquivo deve ser UTF-8

O arquivo XML deve ter um tag principal <trovit>, no qual haverá um conjunto de anúncios representado por blocos de tags <ad></ad>. Cada um desses blocos deve conter campos obrigatórios e opcionais:

CAMPOS OBRIGATÓRIOS

Os campos obrigatórios proporcionam a informação mínima necessária para que o nosso sistema inclua os anúncios no Trovit.

  • id: Id do anúncio no seu site (poderá ser numérico ou alfanumérico, mas deve ser único pois é utilizado para evitar conteúdo duplicado)
  • url: Link do anúncio no seu site
  • title: Título do anúncio (deve ser completamente relacionado com o anúncio, não pode conter nem o nome nem a URL da sua web).
  • type: Tipo de anuncio:
    • “For Rent”: Arrendamento a longo prazo
    • “For Sale”: Venda de imóvel
    • “Roommate”: Dividir casa, alugar quarto
  • content: Descrição do anúncio (mínimo de 30 caracteres)

CAMPOS OPCIONAIS

Os campos opcionais só devem ser incluidos se possuirem conteúdo. Lembre-se de que o sistema do Trovit prioriza os anúncios pela sua qualidade, portanto quanto mais completo seja o seu anúncio, melhor será posicionado.

    • mobile_url: Etiqueta para a URL do anúncio do seu site en distintos idiomas quando o usuario entra desde un smartphone. Útil quando o seu site esta preparado para estes dispositivos.
    • price: Preço de venda ou arrendamento da propriedade.
      A moeda padrão é €. Caso seu anúncio esteja com o preço em uma moeda que não seja o euro, use o atributo ‘currency’. Os valores devem ser determinados pela norma ISO-4217. Assim o sistema do Trovit poderá realizar a conversão corretamente.
      Veja exemplo para um valor em dólares:

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

      Importante: Somente são aceitos números decimais separados por ponto. (Ex:15000.50)
      Não incluir separador de milhares. Não incluir simbolo €. Ver especificações técnicas

      Por padrão o valor está definido para contratos mensais. Para contratos de arrendamento, também é possível definir o período (semanal ou diário). Para isso, use o atributo ‘period’.

      Veja exemplo para um aluguel semanal:

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

      Os valores de ‘period’ disponíveis são: “weekly” ou “daily”.

Veja exemplo com os dois atributos:

<price currency="USD" period="weekly"><![CDATA[...]]></price>
  • property_type: Tipo de propriedade (Somente para venda ou arrendamento. Ex: apartamento, casa, estudio, etc.)
  • floor_area: Área útil da propriedade (A unidade de medida padrão é m². Caso deseje especificar a unidade de medida, use o atributo ‘unit’:
    <floor_area unit="feet"><![CDATA[...]]></floor_area>

    Os valores de ‘unit’ disponíveis são: “meters” ou “feet”.)

  • plot_area: Área total do terreno (Admite somente valores inteiros. A unidade de medida padrão é m². Caso deseje especificar a unidade de medida, use o atributo ‘unit’:
    <plot_area unit="hectares"><![CDATA[...]]></plot_area>

    Os valores de ‘unit’ disponíveis são: “meters”, “feet”, “acres” ou “hectares”.)

  • rooms: Número de quartos
  • bathrooms: Número de casas de banho
  • is_furnished: Se o imóvel está mobiliado (0 = não, 1 = sim)
  • condition : Informação textual sobre as condições do imóvel. (Ex: reformado recentemente)
  • parking: Se possui vagas de garagem (0 = não, 1= sim)
  • floor_number: Número do andar
  • orientation : Orientação do imóvel (Ex: norte, sul, leste, oeste)
  • is_new: Se o imóvel é uma construção nova (0 = não, 1 = sim)
  • year : Ano de construção (Formato: AAAA)
  • region: Distrito
  • city: Concelho
  • city_area : Freguesia
  • address: Morada
  • postcode: Código Postal
  • by_owner: Se a propriedade é de particular (0 = não, 1 = sim. Se for uma propriedade de agência, completar campo agency.)
  • is_rent_to_own: Se é um imóvel de aluguel com opção de compra ou não.
  • eco_score: Informação em texto sobre a eficiência energética do imóvel.
  • agency: Nome da agência (Ver campo by_owner)
  • latitude: Latitude da localização do imóvel (Ver especificações técnicas)
  • longitude: Longitude da localização do imóvel (Ver especificações técnicas)
  • virtual_tour : Link para o tour virtual do imóvel
  • date: Data de publicação do anúncio. Os formatos aceitados são DD/MM/AAAA ou DD/MM/AAAA HH:MM:SS e AAAA/MM/DD ou AAA/MM/DD HH:MM:SS.
  • expiration_date: Data de expiração do anúncio. Os formatos aceitados são DD/MM/AAAA ou DD/MM/AAAA HH:MM:SS e AAAA/MM/DD ou AAA/MM/DD HH:MM:SS.
  • foreclosure : Se a propriedade está a leilão por embargo (0 = não, 1 = sim)
  • mls_database: Identificador único de cada bem imobiliário em uma base de dados MLS (Multiple Listing Service)
  • pictures: Tag que engloba as diversas fotografias do imóvelO campo que define uma imagem particular é a tag <picture>
  • picture: Esta tag engloba os campos para especificar a URL e o título da imagem (este último opcional).As tags para cada elemento <picture> são:
    • picture_url: Link da foto no site
    • picture_title: Título da foto (opcional)
<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>

Importante: A foto mostrada no Trovit será a primeira do conjunto de fotos do anúncio.

O Trovit não permite a inclusão de fotos corporativas com a mensagem “Imagem não disponível”. O Trovit se reserva o direito de bloquear os anúncios que possuam imagens com mensagens corporativas.

Depois que os anúncios sejam indexados no sistema do Trovit não é possível alterar as fotos associadas aos anúncios, nem mesmo na próxima leitura do feed.

As fotos devem ser no mínimo 186x186px, com um peso máximo de 1MB.

O feed XML deve ficar assim:

<?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>
    <floor_area unit="feet"><![CDATA[...]]></floor_area>
    <plot_area unit="feet"><![CDATA[...]]></plot_area>
    <rooms><![CDATA[...]]></rooms>
    <bathrooms><![CDATA[...]]></bathrooms>
    <is_furnished><![CDATA[...]]></is_furnished>
    <condition><![CDATA[...]]></condition>
    <parking><![CDATA[...]]></parking>
    <floor_number><![CDATA[...]]></floor_number>
    <orientation><![CDATA[...]]></orientation>
    <is_new><![CDATA[...]]></is_new>
    <year><![CDATA[...]]></year>
    <region><![CDATA[...]]></region>
    <city><![CDATA[...]]></city>
    <city_area><![CDATA[...]]></city_area>
    <address><![CDATA[...]]></address>
    <postcode><![CDATA[...]]></postcode>
    <by_owner><![CDATA[...]]></by_owner>
    <agency><![CDATA[...]]></agency>
    <latitude><![CDATA[...]]></latitude>
    <longitude><![CDATA[...]]></longitude>
    <virtual_tour><![CDATA[...]]></virtual_tour>
    <date><![CDATA[...]]></date>
    <expiration_date><![CDATA[...]]></expiration_date>
    <foreclosure><![CDATA[...]]></foreclosure>
    <mis_database><![CDATA[...]]></mis_database>
    <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>

</ad>

<ad>
    ....
</ad>

<ad>
    ....
</ad>

...

</trovit>

Exemplo de Feed XML

<?xml version="1.0" encoding="utf-8"?>
<trovit>
<ad>
	<id><![CDATA[7004578]]></id>
	<url><![CDATA[http://www.seudominio.pt/ad/7004578]]></url>
	<title><![CDATA[T3 Lisboa]]></title>
	<type><![CDATA[For rent]]></type>
	<content><![CDATA[T3 semi-remodelado com acabamentos de qualidade,  4 assoalhadas com 85 m2. Prédio c/ elevador e c/ garagem p/ 2 carros.]]></content>

	<price><![CDATA[800]]></price>
	<property_type><![CDATA[Flat]]></property_type>
	<floor_area unit="meters"><![CDATA[85]]></floor_area>
	<rooms><![CDATA[3]]></rooms>
	<bathrooms><![CDATA[1]]></bathrooms>
	<parking><![CDATA[0]]></parking>
	<region><![CDATA[Lisboa]]></region>
	<city><![CDATA[Lisboa]]></city>
	<city_area><![CDATA[Castelo]]></city_area>
	<address><![CDATA[Rua Direita, 50]]></address>
	<postcode><![CDATA[0472-192]]></postcode>
	<by_owner><![CDATA[0]]></by_owner>
	<agency><![CDATA[Agencia Imobiliaria]]></agency>
	<latitude><![CDATA[51.496401]]></latitude>
	<longitude><![CDATA[-0.179]]></longitude>
	<pictures>
		<picture>
			<picture_url><![CDATA[http://www.seudominio.pt/image.jpg]]></picture_url>
			<picture_title><![CDATA[living room]]></picture_title>
		</picture>
	</pictures>
	<date><![CDATA[31/10/2005 18:30]]></date>
</ad>
</trovit>

Especificações Técnicas

Para mais informação: ver especificações técnicas.

Privacy policy · Legal Notice · Terms and conditions · Cookie policy