Articles in this section

See more

Brasil - Feed Casas

Avatar
Thribee Help Center
  • Updated
Follow

Caso tenha um site de classificados inclua seus anúncios no Trovit, Mitula, Nestoria & Nuroa. É 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.

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”: Aluguel a longo prazo
    • “For Sale”: Venda de imóvel
    • “Roommate”: Dividir casa, alugar quarto
    • “Land For Sale”: Venda de terreno
  • 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 estés dispositivos.
    • price: Preço de venda ou aluguel da propriedade.
      A moeda padrão é R$. Caso seu anúncio esteja com o preço em uma moeda que não seja o real, 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 R$.

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

      Veja exemplo para um aluguel mensal:

      <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 aluguel. Ex: apartamento, casa, kitnet, 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 banheiros
    • 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: Estado
    • city: Cidade
    • city_area : Bairro
    • address: Endereço
    • postcode: CEP
    • 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
    • longitude: Longitude da localização do imóvel
    • 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.

FEED XML

<?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>
...
</trovit>

EXEMPLO DE FEED XML

<?xml version="1.0" encoding="utf-8"?>
<trovit>
<ad>
	<id><![CDATA[7004578]]></id>
	<url><![CDATA[http://www.seudominio.com.br/ad/7004578]]></url>
	<title><![CDATA[Sobrado - Zona Sul]]></title>
	<type><![CDATA[For rent]]></type>
	<content><![CDATA[Sobrado, 4 dormitórios,3 suites, 4 vagas de garagem, 2 salas , 1 lavabo, 1 banheiro, área de serviço ]]></content>

	<price><![CDATA[800]]></price>
	<property_type><![CDATA[Flat]]></property_type>
	<floor_area unit="meters"><![CDATA[300]]></floor_area>
	<rooms><![CDATA[3]]></rooms>
	<bathrooms><![CDATA[1]]></bathrooms>
	<parking><![CDATA[0]]></parking>
	<region><![CDATA[São Paulo]]></region>
	<city><![CDATA[São Paulo]]></city>
	<city_area><![CDATA[Ipiranga]]></city_area>
	<address><![CDATA[Rua do Ipiranga, 20]]></address>
	<postcode><![CDATA[04732-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.com.br/image.jpg]]></picture_url>
			<picture_title><![CDATA[living room]]></picture_title>
		</picture>
	</pictures>
	<date><![CDATA[31/10/2005 18:30:04]]></date>
	</ad>

<ad>
	<id><![CDATA[332A53BC2]]></id>
	<url><![CDATA[http://www.seudominio.com.br/ad/332A53BC2]]></url>
	<title><![CDATA[Sobrado, Rio de Janeiro Zona Sul]]></title>
	<type><![CDATA[For sale]]></type>
	<content><![CDATA[Sobrado, 4 dormitórios,3 suites, 4 vagas de garagem, 2 salas , 1 lavabo, 1 banheiro, área de serviço]]></content>
	<price><![CDATA[209950]]></price>
	<address><![CDATA[Rua do Sobrado Verde, 5]]></address>
	<city><![CDATA[Rio de Janeiro]]></city>
	<postcode><![CDATA[34567-123]]></postcode>
	<region><![CDATA[Rio de Janeiro]]></region>
	<pictures>
		<picture>
			<picture_url><![CDATA[http://www.seudominio.com.br/image.jpg]]></picture_url>
			<picture_title><![CDATA[living room]]></picture_title>
		</picture>
	</pictures>
	<date><![CDATA[31/10/2005 18:30:00]]></date>
</ad>
</trovit>

ESPECIFICAÇÕES TÉCNICAS

Para mais informação: ver especificaciones técnicas.

Related articles

Comments

0 comments

Please sign in to leave a comment.