Las consultas de una propiedad
GET /property-v1/properties/{paId}/leads?portal={portal}
Trae las consultas de un aviso, el de la propiedad que indiques.
Para traer todo, usá el método por cuenta. Recorrer tus propiedades una por una gasta una llamada del cupo por cada una, y con el otro método son todas en una. Este método es para cuando querés mirar una sola — el detalle de un aviso en tu panel.
curl "https://property-api.mapaprop.com/property-v1/properties/01M41AQNXYG4W4SEEEEPHEDNX4/leads?portal=zonapropapi&fromDate=20260101" \
-H "Authorization: Bearer $TOKEN" \
-H "x-client-ref: cliente-42"
Los parámetros
portal | obligatorio | zonapropapi |
fromDate | desde qué fecha. YYYYMMDD, u opcionalmente YYYYMMDD HH:mm:ss | si no lo mandás, los últimos 7 días |
toDate | hasta qué fecha, mismo formato | sin tope |
size | cuántos leads por página | 100 |
maxPages | cuántas páginas traemos como máximo | 20 |
Mandá fromDate siempre que quieras más que lo muy reciente. Sin una ventana explícita el portal usa
una propia, muy angosta: el mismo aviso que devuelve 8 consultas con fromDate de nueve meses atrás
devuelve 1 sin el parámetro. Si no lo mandás, parece que el aviso casi no tuviera consultas.
La respuesta
{
"portal": "zonaprop",
"paId": "2605257",
"from": "20260101",
"to": "20260601",
"leads": [
{
"eventId": "evt_src_322337250",
"event": "lead.created",
"occurredAt": "2026-11-15T03:07:08Z",
"clientRef": "cliente-42",
"source": {
"source": "mapaprop",
"case": "zonaprop",
"subcase": "api",
"ids": { "messageId": null, "adId": "56801168", "contactId": "49474924", "actionId": "10" }
},
"data": {
"questionId": null,
"messageId": "322337250",
"direction": "incoming",
"message": "Hola, quería coordinar una visita",
"contact": { "name": "Lucía", "email": "lucia@ejemplo.com", "phone": "1156781234" },
"customer": null,
"property": { "propertyId": null, "paId": null, "code": "2605257___mapaprop" },
"raw": null
}
}
],
"total": 8,
"quota": { "remaining": 1346, "limit": 1500 }
}
Es la misma forma que el método por cuenta, más el paId que pediste.
Este método no existe para mapapropapi. Esa fuente se pide sólo
por cuenta, porque no toda consulta que entra a una cuenta
de Mapaprop es sobre un aviso —el 16,9 % no lo es— y pedirlas por propiedad dejaría afuera
justamente las que no se pueden pedir de otra forma.
Capacidades lo dice con byProperty: false.
El objeto lead, campo por campo, está en la introducción.
to aparece sólo si mandaste toDate, y trae el valor que se aplicó de verdad.
Un toDate sin hora es el final de ese día. Si mandás 20261013, lo tomamos como
20261013 23:59:59 para que el 13 entre, y te lo avisamos en warnings. El portal lee una fecha
sin hora como las 00:00:00, así que a secas te habría dejado afuera el día entero. Si querés otro
corte, mandá la hora (20261013 18:00:00) y la respetamos tal cual.
Si el aviso no está en el portal
No es un error: es 200, con la lista vacía y el motivo.
{
"portal": "zonaprop",
"paId": "01M41AQNXYG4W4SEEEEPHEDNX4",
"from": "20260929",
"leads": [],
"total": 0,
"notPublishedOnPortal": true,
"detail": "Ese aviso no figura en esa inmobiliaria del portal, así que no tiene consultas. Puede que todavía no se haya publicado, que el portal lo haya dado de baja, o que esté publicado bajo otra cuenta.",
"quota": { "remaining": 1346, "limit": 1500 }
}
El portal nos dice "ese aviso no figura en esta inmobiliaria" y nada más, así que no podemos decirte cuál de las tres razones es. Preferimos nombrarte las tres antes que elegir una y arriesgarnos a mandarte a buscar donde no está.
La propiedad sí existe en tu inventario — si no existiera, la respuesta sería un 404.
Los errores
| Cuándo | Qué hacer | |
|---|---|---|
400 portal_required | falta ?portal= | mandalo |
| 403 | te falta el scope {portal}:leads | pedinos que te lo otorguemos |
404 property_not_found | ese paId no está en tu inventario | revisá el id. No gasta cupo: cortamos antes de preguntarle al portal |
409 portal_not_connected | esa cuenta no está conectada a ese portal | conectala |
409 portal_account_unlinked | la desvincularon del lado del portal | hay que volver a conectarla |
429 portal_quota_exhausted | la inmobiliaria agotó su cupo del mes | esperar al mes siguiente. El cupo se comparte con publicar — ver el cupo de Zonaprop |
501 leads_not_supported | ese portal todavía no ofrece este servicio | — |
502 portal_rejected | el portal no contestó o rechazó la consulta | reintentar es seguro |
Antes de armar la llamada, mirá qué modo soporta ese portal.
No todos ofrecen este servicio, y así te enterás como dato en vez de por un 501.