Mapaprop

Get Started con Feeds API

Consulta miles de propiedades para construir tu portal.

1. Obtén tu access token

Registra tu aplicación y sigue Getting Started.

2. Flujo básico

Buscamos darte la forma más rápida de mantener actualizada la lista de propiedades. El flujo básico es:

  1. El día 1, llama a GET /api/action/feed-v1/get-total para conocer el total de propiedades disponibles.
  2. Con el total conocido, descarga los datos en lotes de 500 propiedades usando GET /api/action/feed-v1/get-properties. Limitamos la cantidad de requests: evita hacer más de 2 llamadas concurrentes o vas a empezar a recibir errores HTTP 503.
  3. A partir de ahí, día a día llama a GET /api/action/feed-v1/get-delta para obtener la diferencia (altas vs bajas) del día y evitar releer grandes volúmenes de datos. El delta acepta fecha: si te salteas un día, puedes pedir qué cambió en esa fecha puntual.

El agencyId (identificador de la inmobiliaria)

Cada propiedad del feed incluye el objeto agency con su campo id (llamado agencyId en otros métodos): un identificador único, estable y opaco de la inmobiliaria que publica. Trátalo como un string opaco: guárdalo tal cual lo recibes y no intentes parsearlo ni interpretarlo.

Para qué te sirve:

  1. Agrupar propiedades por inmobiliaria: todas las propiedades de una misma agencia comparten el mismo agency.id.
  2. Devolver consultas: envía el valor tal cual en POST submit-question.
  3. Vincular una agencia con su cuenta en tu portal: si una inmobiliaria se registra en tu portal con su email, puedes obtener su agencyId con Customer API (GET /api/action/customer-v1/{email}) y asociar su cuenta con sus propiedades del feed. El email nunca viaja en el feed: lo aporta la propia agencia al registrarse.

El mismo identificador se usa en Feeds API, Network API y Customer API.

Descarga de imágenes

Por los costos de transferencia de datos, todas las imágenes deben servirse desde tus servidores. Para eso necesitas descargarlas desde los nuestros. Para prevenir el mal uso, necesitamos saber qué User-Agent usa tu bot de descarga o desde qué rango de IPs viene. Contacta a Mapaprop para informarlo. Bloqueamos todo el tráfico anónimo o sospechoso. (Ejemplo de User-Agent: Empresa/Version, como Mapaprop/1.2.3)

Con tu access token de Mapaprop ya puedes acceder a Feeds API. Estos son los métodos:

GET /api/action/feed-v1/get-total

GET /api/action/feed-v1/get-properties

GET /api/action/feed-v1/get-delta

GET /api/action/feed-v1/get-delta-network

POST /api/action/feed-v1/submit-question

4. Copyright

El copyright de las imágenes y los datos pertenece a Mapaprop. A través del acuerdo de feed, Mapaprop autoriza a los consumidores a usar ambos.