BETA

Devuelve el detalle completo de un conjunto de propiedades a partir de sus IDs, con paginación y orden opcional. Está pensado para el panel de resultados del chat: primero se obtienen los IDs con GET /api/action/mapaprop-chat-ai-v1/search y después se resuelve el detalle de a páginas de hasta 10 propiedades con este endpoint.

customerId se resuelve del access token. Solo se devuelven propiedades que pertenezcan a la cuenta autenticada; cualquier ID de otra cuenta se descarta en silencio.

Información del recurso
AutenticaciónRequerida (Token de API, Bearer)
HTTP MethodGET
ResponseJSON
Version1

URL del recurso

https://mapaprop.app/api/action/mapaprop-chat-ai-v1/properties

Parámetros

KeyTypeRequiredDescripción
propertyIdsstringyesLista de IDs de propiedad separados por coma (ej: "2600144,2600145,2600150"). Los valores no numéricos se ignoran en silencio
fromintnoOffset de paginación, base cero. Por defecto 0
sizeintnoCantidad de resultados por página. Por defecto 10. Si se envía un valor mayor a 10, se ajusta a 10 (no genera error)
sortstringnoOrden de los resultados. Valores válidos: price_desc, price_asc, area_desc, bedrooms_desc. Cualquier otro valor se ignora y los resultados se devuelven en el orden de propertyIds

Código de ejemplo

GET /api/action/mapaprop-chat-ai-v1/properties?propertyIds=2600144,2600145,2600150&from=0&size=10&sort=price_desc HTTP/1.1
Host: mapaprop.app
Content-Type: application/x-www-form-urlencoded
Content-Length: 0
Authorization: Bearer {access_token}

Respuesta

ObjetoCampoTipoRequeridoDescripción
ResponsepropertiesArray of PropertyyesLa página de propiedades resuelta
totalintyesCantidad total de IDs recibidos en propertyIds (no es un conteo de una búsqueda; es simplemente propertyIds.length)
fromintyesEl offset recibido, tal cual
sizeintyesCantidad de propiedades devueltas en esta página (puede ser menor al size solicitado)
hasMorebooleanyesSi quedan más propiedades después de esta página
PropertypropertyIdintyesID de la propiedad
codestringyesCódigo de la propiedad ingresado por el cliente, sin el prefijo de cuenta
titlestringyesTítulo de la propiedad
descriptionstringyesDescripción de la propiedad
descriptionFormattedstringnoDescripción con saltos de línea
seoUrlstringyesRuta SEO de la propiedad en el sitio del cliente
typeintyesID del tipo de propiedad. GET /api/action/mapaprop-chat-ai-v1/types
propertyTypestringyesDescripción traducida del tipo
operationintyesID de la operación. GET /api/action/mapaprop-chat-ai-v1/operations
propertyOperationstringyesDescripción traducida de la operación
statusstringnoDescripción traducida del estado de construcción
priceintyesPrecio de la propiedad
currencystringyesMoneda del precio
expensesPriceintnoMonto de expensas
expensesCurrencystringnoMoneda de las expensas
taxPriceintnoMonto de impuestos
taxCurrencystringnoMoneda de los impuestos
addressstringnoDirección de la propiedad
countryIdintyesID del país
stateIdintyesID de la provincia (zone1)
countyIdintnoID del partido (zone2)
cityIdintnoID de la ciudad/barrio (zone3)
countrystringyesNombre del país
statestringnoNombre de la provincia
countystringnoNombre del partido
citystringnoNombre de la ciudad/barrio
customerCountryDescstringyesNombre del país de la cuenta del cliente
bedroomsintnoCantidad de dormitorios
ambiencesintnoCantidad de ambientes
bathroomsintnoCantidad de baños
totalSurfacenumbernoSuperficie total en m². Puede no estar presente en propiedades cargadas solo con buildingArea/landArea
buildingAreaintnoSuperficie cubierta en m²
landAreaintnoSuperficie de terreno en m²
garageintnoCantidad de cocheras
garageTypestringnoDescripción del tipo de cochera
soldbooleanyesSi la propiedad fue marcada como vendida
rentedbooleanyesSi la propiedad fue marcada como alquilada
reservedbooleanyesSi la propiedad fue reservada
suspendedbooleanyesSi la publicación fue suspendida
mainImagestringyesURL completa de la imagen principal
imagesArray of ImagenoImágenes de la propiedad
mapLatitudestringnoLatitud
mapLongitudestringnoLongitud
mapEmbedUrlstringnoURL lista para embeber un mapa (Google Maps), solo si la propiedad tiene coordenadas
labelsArray of stringnoLabels de amenities/atributos destacados. Constantes
attributesArray of objectnoAtributos activos de la propiedad
ImageimagestringyesURL de la imagen
thumbnailstringyesURL del thumbnail

Ejemplo de respuesta

{
    "properties": [
        {
            "propertyId": 2600144,
            "code": "casas236516",
            "title": "Departamento 2 ambientes en Palermo",
            "description": "Excelente departamento a estrenar...",
            "seoUrl": "venta-de-departamento-en-palermo-capital-federal-11099-2600144",
            "type": 1,
            "propertyType": "Departamento",
            "operation": 1,
            "propertyOperation": "Venta",
            "price": 210000,
            "currency": "USD",
            "address": "Av. Santa Fe 3200",
            "countryId": 1,
            "stateId": 1,
            "countyId": 46,
            "country": "Argentina",
            "state": "Capital Federal",
            "county": "Palermo",
            "customerCountryDesc": "Argentina",
            "bedrooms": 2,
            "bathrooms": 1,
            "totalSurface": 55,
            "sold": false,
            "rented": false,
            "reserved": false,
            "suspended": false,
            "mainImage": "https://s3.amazonaws.com/mapaprop-dev/photos/11099/2600144/1t.jpg",
            "images": [
                {
                    "image": "https://s3.amazonaws.com/mapaprop-dev/photos/11099/2600144/1.jpg",
                    "thumbnail": "https://s3.amazonaws.com/mapaprop-dev/photos/11099/2600144/1t.jpg"
                }
            ],
            "mapLatitude": "-34.5875",
            "mapLongitude": "-58.4205",
            "mapEmbedUrl": "https://www.google.com/maps/embed/v1/place?key=...&q=-34.5875,-58.4205&zoom=15",
            "labels": ["furnished", "grill"]
        }
    ],
    "total": 3,
    "from": 0,
    "size": 1,
    "hasMore": true
}

Si no se envía propertyIds, o ninguno de sus valores es un número válido, el servicio responde HTTP 400 con un JSON de error: {"error": "REQUIRED_INPUT", "description": "validation failed"} cuando falta el parámetro, o {"error": "REQUIRED_INPUT", "description": "No valid property IDs provided"} cuando se envían solo valores no numéricos.