PROD

A geração do feed é realizada todos os dias às 2h UTC

Informações do recurso
Autenticação	Obrigatória
Scope	`feed-static-{country}` (por país, veja abaixo)
Método HTTP	GET
Resposta	GZIP
Versão	1

URL do recurso

https://mapaprop.app/api/action/feed-static-v1/download

Parâmetros

Chave	Tipo	Obrigatório	Descrição
country	string	sim	O código ISO do país. Suportados: AR, UY, ES, CL, MX, CO. Constantes

Scopes

Seu cliente deve ter um scope por país que deseja baixar. Se o scope para o país solicitado não estiver habilitado nas suas credenciais, você receberá um erro SCOPE_NOT_VALID.

Scope	País
`feed-static-ar`	Argentina
`feed-static-uy`	Uruguay
`feed-static-es`	España
`feed-static-cl`	Chile
`feed-static-mx`	México
`feed-static-co`	Colombia

Os scopes são habilitados pela Mapaprop quando sua aplicação é aprovada. Se precisar de um país adicional, entre em contato conosco.

Código de exemplo

GET /api/action/feed-static-v1/download?country=AR HTTP/1.1
Host: mapaprop.app
Authorization: Bearer {access_token}

Resposta

Será feito o download de um arquivo gzip contendo o XML do feed gerado para a data atual. Há uma lista de objetos de imóveis com anúncios em seu interior. Cada anúncio tem o seguinte formato.

Objeto	Campo	Tipo	Obrigatório	Descrição
Ad	ad	Object	sim	O objeto principal do anúncio
	id	String	sim	O identificador único do imóvel
	url	String	sim	A URL do imóvel no nosso portal
	title	String	sim	O título do imóvel
	type	String	sim	O tipo de operação: "For sale", "For rent", "Short term rental", "For Barter", "For Share", "For Transfer"
	currency	String	sim	A moeda do imóvel
	agency	String	sim	O nome da imobiliária ou corretor que publica o imóvel
	content	String	sim	Uma descrição geral do imóvel
	price	Integer	sim	O preço do imóvel
	property_type	String	sim	O tipo do imóvel (Apartamento, Casa, etc.)
	rooms	Integer	não	A quantidade de quartos
	bathrooms	Integer	não	A quantidade de banheiros
	parking	Integer	não	A quantidade de vagas de garagem
	address	String	sim	O endereço do imóvel
	city	String	sim	A cidade do imóvel
	region	String	sim	A região do imóvel
	latitude	Double	não	A latitude do imóvel
	longitude	Double	não	A longitude do imóvel
	date	String	sim	A data de publicação do imóvel DD/MM/YYYY
	expiration_date	String	sim	A data de vencimento da publicação. Quase sempre renovada automaticamente
	orientation	String	não	Orientação cardinal do imóvel (este, oeste, norte...)
	condition	String	não	Estado de conservação do imóvel
	is_furnished	String	não	Se o imóvel possui mobília ou não. Útil para locações temporárias.

Exemplo

<?xml version="1.0" encoding="UTF-8"?>
<properties>
  <ad>
    <id><![CDATA[56272]]></id>
    <url>https://www.memudoya.com/en/property/venta-de-departamento-en-caballito-capital-federal-317-253763/6b8dd3bc51a74cc5d0b4144278d55e9d]]></url>
    <title><![CDATA[Piso 3 dor. con vistas a la playa]]></title>
    <type><![CDATA[For Sale]]></type>
    <agency><![CDATA[Real Estate]]></agency>
    <content><![CDATA[CODIGO: 2214A-V020 ubicado en: calle Pola de Siero -  Publicado por: REAL ESTATE. Departamento en Venta en Torrevieja, Vega Baja del Segura, Alicante. El precio es EUR 95000. El estado es Excelente. Su antigüedad es de 15 años. La superficie cubierta es de 90 metros cuadrados. Su orientacion es Este. Servicios en el Departamento: . El Departamento cuenta con: 3 Dormitorios. 2 Baños. Cochera. Publicado a través de Mapaprop]]></content>
    <currency><![CDATA[EUR]]></currency>
    <price><![CDATA[95000]]></price>
    <property_type><![CDATA[Departamento]]></property_type>
    <rooms><![CDATA[3]]></rooms>
    <bathrooms><![CDATA[2]]></bathrooms>
    <parking><![CDATA[1]]></parking>
    <address><![CDATA[calle Pola de Siero]]></address>
    <city><![CDATA[Vega Baja del Segura]]></city>
    <region><![CDATA[Alicante]]></region>
    <latitude><![CDATA[37.9842926]]></latitude>
    <longitude><![CDATA[-36.0000047]]></longitude>
    <date><![CDATA[01/05/2014]]></date>
    <expiration_date><![CDATA[25/01/2017]]></expiration_date>
    <orientation><![CDATA[Este]]></orientation>
    <condition><![CDATA[Excelente]]></condition>
    <is_furnished><![CDATA[1]]></is_furnished>
  </ad>
</properties>

Exemplos

<?php

// init the URL
$ch = curl_init("https://mapaprop.app/api/action/feed-static-v1/download?country=AR");
// set your user agent
curl_setopt($ch, CURLOPT_USERAGENT, "YourCompany/1.0");
$headers = array('Authorization: Bearer ' . $YOURTOKEN); // here your token!
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
// execute the file download
$output = curl_exec($ch);

// Close the cURL resource, and free system resources
curl_close($ch);
?>