La generación del feed se realiza todos los días a las 2 AM UTC
| 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);
?>