PROD

La generación del feed se realiza todos los días a las 2 AM UTC

Recomendación — quedate con el inventario vigente. Mapaprop tiene muchas inmobiliarias que publican de forma gratuita, y con el tiempo algunas abandonan sus avisos: no vuelven a la cuenta ni los actualizan. Vamos depurando esas cuentas de a poco, pero el feed puede incluir avisos publicados hace años que siguen técnicamente publicados. El campo date es la fecha de publicación original, no la última edición, así que una fecha antigua es esperable y no significa que el aviso esté inactivo. Para trabajar solo con inventario fresco, filtrá por el campo date de tu lado (por ejemplo, quedándote con el último año) y resincronizá el feed a diario (se regenera cada día a las 2 AM UTC): lo que deja de aparecer, se dio de baja.

Información del recurso
Autenticación	Requerida
Scope	`feed-static-{country}` (por país, ver más abajo)
Método HTTP	GET
Respuesta	GZIP
Versión	1

URL del recurso

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

Parámetros

Clave	Tipo	Requerido	Descripción
country	string	sí	El código ISO del país. Soportados: AR, UY, ES, CL, MX, CO. Constantes

Scopes

Tu cliente debe tener un scope por país que quieras descargar. Si el scope para el país solicitado no está habilitado en tus credenciales, obtendrás un error 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

Los scopes son habilitados por Mapaprop cuando se aprueba tu aplicación. Si necesitás un país adicional, contactanos.

Código de ejemplo

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

Respuesta

Se descarga un archivo gzip con el XML del feed generado para la fecha actual. Contiene una lista de objetos de propiedades con avisos en su interior. Cada aviso tiene el siguiente formato.

Objeto	Campo	Tipo	Requerido	Descripción
Ad	ad	Object	sí	El objeto principal del aviso
	id	String	sí	El identificador único de la propiedad
	url	String	sí	La URL de la propiedad en nuestro portal
	title	String	sí	El título de la propiedad
	type	String	sí	El tipo de operación: "For sale", "For rent", "Short term rental", "For Barter", "For Share", "For Transfer"
	currency	String	sí	La moneda de la propiedad
	agency	String	sí	El nombre de la inmobiliaria o corredor que publica la propiedad
	content	String	sí	Una descripción general de la propiedad
	price	Integer	sí	El precio de la propiedad
	property_type	String	sí	El tipo de propiedad (Departamento, Casa, etc.)
	rooms	Integer	no	La cantidad de dormitorios
	bathrooms	Integer	no	La cantidad de baños
	parking	Integer	no	La cantidad de cocheras
	address	String	sí	La dirección de la propiedad
	city	String	sí	La ciudad de la propiedad
	region	String	sí	La región de la propiedad
	latitude	Double	no	La latitud de la propiedad
	longitude	Double	no	La longitud de la propiedad
	date	String	sí	La fecha de publicación de la propiedad DD/MM/YYYY
	expiration_date	String	sí	La fecha de vencimiento de la publicación. Casi siempre se renueva automáticamente
	orientation	String	no	Orientación cardinal de la propiedad (este, oeste, norte...)
	condition	String	no	Estado de la propiedad (qué tan buena o mala está)
	is_furnished	String	no	Si la propiedad tiene muebles o no. Útil para alquileres temporarios.

Ejemplo

<?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>

Ejemplos

<?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);
?>