PROD

Este servicio devuelve la lista de propiedades del cliente.

Información del recurso
AutenticaciónRequired
Método HTTPGET
RespuestaJSON
Versión1

URL del recurso

https://mapaprop.app/api/action/portal-v2/properties/{country}/

Ejemplo de llamada

GET /api/action/portal-v2/properties/{country}/?operation=1&buildingStatus=5?currency=USD?tempOccupancy=2&dateFrom=20-02-2019&dateTo=28-02-2019 HTTP/1.1
Host: mapaprop.app
Content-Type: application/x-www-form-urlencoded
Content-Length: 0
Authorization: Bearer {access_token}

Parámetros

ClaveTipoRequeridoDescripción
termstringnoTérmino que intenta coincidir con al menos 3 caracteres en la zona, dirección o título de la propiedad. Búsqueda de texto completo.
countryint/stringyesEl país desde el cual se hace la consulta. Constantes
typeintyesTipo de propiedad. Constantes
operationintyesOperación de la propiedad. Constantes
fromintyesNúmero de registro de inicio
sizeintyesCantidad de registros por consulta. Máximo por defecto: 20 - Limitado
bedroomsintnoCantidad de dormitorios
ambiencesintnoNúmero exacto de ambientes
ambiencesFromintnoBuscar desde un número en adelante
ambiencesTointnoBuscar hasta el número asignado
bathroomsintnoCantidad de baños
countryIdintnoID del país de la propiedad
stateIdintnoID de la provincia
countyIdintnoID del partido / condado
cityIdintnoID de la ciudad
buildingStatusintnoEstado físico del edificio. Constantes
tempOccupancyintnoCantidad de personas que pueden vivir en la propiedad
dateFromstringnoFecha de llegada (formato "dd-MM-yyyy")
dateTostringnoFecha de salida (formato "dd-MM-yyyy")
priceFromintnoPrecio mínimo de búsqueda
priceTointnoPrecio máximo de búsqueda
currencystringnoMoneda del precio de la propiedad. Máx 3 chars, Mín 2 chars
brokerIdintnoID del agente de las propiedades

Respuesta

Un documento JSON con la lista de propiedades que coinciden con los filtros.

ObjetoCampoTipoRequeridoDescripción
ResponsetookintyesTiempo que tardó la búsqueda en milisegundos
totalintyesTotal de registros disponibles. Podés paginar a través de ellos
FiltersArray of filtersyesLista de filtros aplicados en la URL
brokerIdfilter intFiltro de ID de agente en la respuesta
propertiesArray of PropertyyesLista de objetos Property
PropertypropertyHashstringyesID único de la propiedad
custIdintyesID del cliente
timestampstringyesTimestamp ISO8601 de cuándo se creó la propiedad
lastUpdatestringyesTimestamp ISO8601 de la última actualización
codestringyesCódigo único de la propiedad ingresado por el cliente
branchIdintyesID de la sucursal asociada. GET /api/action/express-v1/branches.
typestringyesDescripción traducida del tipo de propiedad. GET /api/action/portal-v2/settings/types/{country}
operationstringyesDescripción traducida de la operación. GET /api/action/portal-v2/settings/operations/{country}
propertyTypestringyesID del tipo de propiedad. GET /api/action/portal-v2/settings/types/{country}
propertyOperationintyesID de la operación. GET /api/action/portal-v2/settings/operations/{country}
statusstringyesDescripción traducida del estado edilicio. Constantes
mainImagestringnoURL del thumbnail principal de la propiedad
currencystringyesSímbolo de moneda del precio. Constantes
priceintyesPrecio de la propiedad
expensesCurrenciesstringnoSímbolo de moneda de las expensas. Constantes
expensesPriceintnoMonto de las expensas mensuales / anuales
taxCurrencystringnoSímbolo de moneda de los impuestos. Constantes
taxPriceintnoMonto de los impuestos mensuales / anuales
titlestringyesTítulo ingresado por el cliente
addressstringyesCalle y número de la propiedad
zipCodestringyesCódigo postal de la ubicación
zonestringyesDescripción amigable que combina ciudad (si está disponible) y provincia
countryIdintyesID del país de la propiedad
stateIdintyesID de la provincia. GET /api/action/express-v1/zones
countyIdintyesID del partido / condado. GET /api/action/express-v1/zones
cityIdintnoID de la ciudad. GET /api/action/express-v1/zones
countryIdintyesID del país. GET /api/action/express-v1/zones
countrystringyesNombre del país
statestringyesNombre de la provincia
countystringyesNombre del partido o segunda división
citystringnoNombre de la ciudad / barrio o tercera división
suspendedbooleanyesLa publicación fue suspendida
reservedbooleanyesLa propiedad fue reservada
rentedbooleanyesLa propiedad fue alquilada
soldbooleanyesLa propiedad fue vendida
descriptionstringyesDescripción larga de la propiedad
conditionsstringnoCondiciones de la propiedad. Generalmente relacionadas con el pago
bedroomsintnoCantidad de dormitorios
ambiencesintnoCantidad de ambientes
bathroomsintnoCantidad de baños
dependenciesintnoCantidad de dependencias (cuartos extra)
occupancyintnoCantidad de ocupantes (generalmente para alquiler temporal)
toilettesintnoCantidad de toilettes (medios baños)
buildingAreaintnoMetros cuadrados de superficie cubierta
landAreaintnoMetros cuadrados de terreno
yearsOldintnoAntigüedad de la propiedad
ubicationstringnoOrientación cardinal de la propiedad en el edificio
totalFloorsintnoTotal de pisos del edificio
apartmentsPerFloorintnoCantidad de departamentos por piso
airConditionerTypestringnoTipo de aire acondicionado
waterHeaterTypestringnoTipo de calefón
heatingTypestringnoTipo de calefacción
balconyTypestringnoTipo de balcón
garageintnoCantidad de garajes de la propiedad
garageTypestringnoTipo de garage
imagesArray of ImagenoArray de objetos Image
locationLocationyesObjeto de ubicación geográfica
LocationlonstringyesLongitud de la propiedad
latstringyesLatitud de la propiedad
ImageimagestringyesURL de la imagen
thumbnailstringyesURL del thumbnail
orientationintyesOrientación de la imagen. 1 = PORTRAIT, 2 = LANDSCAPE
typeintyesTipo de imagen. 1 = PHOTO, 2 = BLUEPRINT
contentTypestringyesTipo de contenido de la imagen
timestampstringyesTimestamp ISO8601 de cuando se subió la imagen
LabelslabelsArray of labelsnoEtiquetas / amenidades de la propiedad - Constantes
ObjectFieldTypeRequiredDescription
FiltersbedroomsintnoCantidad de dormitorios en la propiedad
sizeintyesTamaño de la respuesta de propiedades
fromintyesInicio de la consulta
tempOccupancyintnoEstado de ocupación temporal
dateTodatenoFecha de fin del período de disponibilidad
dateFromdatenoFecha de inicio del período de disponibilidad
buildingStatusintnoEstado del edificio (por ejemplo: como nuevo, en construcción, terminado)
cityzone0IdintnoID del país
zone3IdintnoID de la zona3
zone1IdintnoID de la zona1
zone2IdintnoID de la zona2
descriptionstringnoDescripción de la zona3
countyzone0IdintnoID del país
zone1IdintnoID de la zona1
zone2IdintnoID de la zona2
descriptionstringnoDescripción de la zona2
statezone0IdintnoID del país
zone1IdintnoID de la zona1
descriptionstringnoDescripción de la zona1
countryzone0IdintnoID del país
descriptionstringnoDescripción de la zona0
typeidintyesID del tipo de propiedad
namestringyesNombre del tipo de propiedad (ej. casa)
operationidintyesID de la operación
namestringyesNombre de la operación (ej. venta, alquiler)
searchInfosearchInfoJSONyesInformación sobre la búsqueda actual
removedremovedListnoLista de filtros removidos
searchTypesearchTypeStringyesTipo de búsqueda actual
commentcommentStringnoAclaración sobre los resultados de búsqueda

El grupo de desarrollo

Toda propiedad trae estos cuatro campos, sea o no un desarrollo. Siempre vienen: un valor en 0, en false o en [] significa "no aplica", no "falta el dato".

CampoTipoEn un desarrolloEn una unidadEn una propiedad común
developmentbooleantruefalsefalse
developmentIdint0 (no tiene padre)el propertyId del desarrollo0
developmentPropertiesArraylos propertyId de sus unidades[][]
developmentStatsObjectlos números derivados — ver abajoausenteausente

developmentStats es el único que no siempre está: se escribe sólo en un desarrollo que tenga unidades vinculadas. Un proyecto sin unidades cargadas no lo trae, y eso es correcto — no hay nada de qué derivarlo.

Los 10 campos declarados del proyecto

Los declara la inmobiliaria y sólo tienen sentido en un desarrollo. Un contador en 0 significa que no se declaró, no que valga cero.

CampoTipoDescripción
commercialTaglinestringLa leyenda comercial del proyecto
deliveryDatestringFecha de entrega, en formato ISO con zona horaria
logoUrlstringEl logo del proyecto — distinto del logo de la inmobiliaria
totalApartmentsintDepartamentos
totalHousesintViviendas
totalLotsintLotes
totalTowersintTorres
totalElevatorsintAscensores
totalOfficesintOficinas
totalCommercialUnitsintLocales comerciales

developmentStats — los números derivados de las unidades

Se calculan en el backend a partir de las unidades vinculadas, una sola vez y para todas las superficies. No se derivan de los 10 campos de arriba: aquéllos son lo que el proyecto anuncia, éstos son lo que sus unidades cargadas dicen.

BloqueCampos
unitstotal · available · sold · rented · reserved · suspended · withOperation · availabilityRate
buildingAreatotal · available · sold · rented · reserved · unavailable · unit
pricesbyCurrency (por moneda: units · from · to · average · total) · mixedCurrencies
sale · rent · otherOperationunits · commercialized · rate
typologybyAmbiences · byRooms · byBuildingArea · byLandArea — conteo de unidades por valor

Si mixedCurrencies es true, el desarrollo tiene unidades en más de una moneda y no existe un rango único: hay que leer byCurrency moneda por moneda. Mostrar un solo rango mezclando monedas da un número que no significa nada.

Ejemplo del grupo

{
    "development": true,
    "developmentId": 0,
    "developmentProperties": [257092, 257093, 257094, 257095],
    "commercialTagline": "Torres del Parque, el emprendimiento que cambia el barrio",
    "deliveryDate": "2028-03-15T00:00:00.000-03:00",
    "totalApartments": 120,
    "totalTowers": 3,
    "developmentStats": {
        "units": { "total": 4, "available": 4, "sold": 0, "availabilityRate": 100 },
        "buildingArea": { "total": 936, "available": 936, "unit": "m2" },
        "prices": {
            "byCurrency": { "ARS": { "units": 4, "from": 2333333, "to": 2333333, "average": 2333333 } },
            "mixedCurrencies": false
        }
    }
}

Ejemplo de respuesta

{
  "took": 11,
  "total": 197,
  "searchInfo": {
      "removed": [
          "zone3"
      ],
      "searchType": "alternativeSearch",
      "comment": "No se encontraron resultados para la búsqueda con el filtro 'zone3'. Mostrando resultados con los filtros alternativos."
  },
   "filters": {
        "bedrooms": "1",
        "size": "20",
        "tempOccupancy": "2",
        "dateTo": "28-02-2019",
        "from": "1",
        "state": {
            "zone0Id": 1,
            "description": "Buenos Aires",
            "zone1Id": 2
        },
        "country": {
            "zone0Id": 1,
            "description": "Argentina",
        },

        "dateFrom": "20-02-2019",
        "type": {
            "name": "Departamento",
            "id": "1"
        },
        "operation": {
            "name": "Alquiler Temporario",
            "id": "3"
        },
        "buildingStatus": "6"
    },
  "properties": [
    {
      "country": "Argentina",
      "custId": 123,
      "heatingType": "Estufas",
      "occupancy": 2,
      "waterHeaterType": "Termotanque",
      "landArea": 200,
      "county": "Chilecito",
      "buildingArea": 120,
      "ubication": "Lateral",
      "cityId": 4011,
      "type": "Departamento",
      "propertyType": "Departamento",
      "apartmentsPerFloor": 3,
      "zone": "Colonia Malligasta, Chilecito, La Rioja, Argentina",
      "price": 2500,
      "airConditionerType": "Split/Ventana",
      "state": "La Rioja",
      "branchId": 23443,
      "images": [
        {
          "image": "https://s3.amazonaws.com/mapaprop-dev/photos/2342/92478/755270.jpg",
          "thumbnail": "https://s3.amazonaws.com/mapaprop-dev/photos/234/92478/755270t.jpg",
          "orientation": 1,
          "imageId": 234432,
          "main": true,
          "type": 1,
          "contentType": "image/jpeg",
          "timestamp": "2015-11-18T22:47:53Z"
        },
        {
          "image": "https://s3.amazonaws.com/mapaprop-dev/photos/234/9242348/755271.jpg",
          "thumbnail": "https://s3.amazonaws.com/mapaprop-dev/photos/1687/2/34755271t.jpg",
          "orientation": 2,
          "imageId": 234,
          "main": false,
          "type": 1,
          "contentType": "image/jpeg",
          "timestamp": "2015-11-18T22:48:23Z"
        }
      ],
      "bathrooms": 1,
      "suspended": false,
      "dependencies": 3,
      "labels": [
        "mortgageReady",
        "professionalAvailable",
        "furnished",
        "janitor",
        "grill",
        "security",
        "securityBox",
        "swimmingPool",
        "partySaloon",
        "cableIncluded",
        "heating",
        "airConditioning",
        "telephoneLine",
        "dialyDinning",
        "alarm",
        "frontGarden",
        "garage",
        "laundry",
        "patio",
        "playroom",
        "privateElevator",
        "suite"
      ],
      "bedrooms": 2,
      "ambiences": 2,
      "balconyType": "Terraza",
      "yearsOld": 2,
      "reserved": false,
      "lastUpdate": "2017-11-01T06:40:40.000-04:00",
      "paymentPeriod": "Por mes",
      "conditions": "•\tAlquiler pago mes a mes. •\tDepósito de 1 mes de alquiler. •\tComisión inmobiliaria. ",
      "status": "A Refaccionar",
      "code": "1687-paunero.lasheras-102apt",
      "expensesCurrency": "USD",
      "city": "Colonia Malligasta",
      "description": "Muy luminoso departamento muy bien ubicado en Palermo - Gran balcón - Totalmente amoblado - Gran Sofa - Cocina completamente equipada - Cama grande - baño completo - Tv con Cable - Wifi - Todo INCLUIDO",
      "alternativePrices": [],
      "title": "Hermoso y muy Luminoso depto ubicado en Palermo",
      "totalFloors": 2,
      "countryId": 1,
      "toilettes": 2,
      "seoUrl": "alquiler-temporario-de-departamento-en-colonia-malligasta234-la-rioja-16e87-344",
      "rented": false,
      "expensesPrice": 322,
      "countyId": 561,
      "hightlight": {},
      "currency": "ARS",
      "timestamp": "2015-11-18T00:00:00.000-05:00",
      "sold": true,
      "orientation": "NORTE",
      "address": "Paunero ",
      "zipCode": "1661",
      "stateId": 12,
      "propertyHash": "9cd969ac3a4623sdffd2cfeea1abab7",
      "mainImage": "https://s3.amazonaws.com/mapaprop-dev/photos/32443/2434/755270t.jpg",
      "taxCurrency": "USD",
      "garage": 2,
      "garageType": "Garage Cubierto",
      "taxPrice": 329032,
      "location": {
        "lon": "-58.409215670639014",
        "lat": "-34.58256378363613"
      },
      "operation": "Alquiler Temporario",
      "propertyOperation": "Alquiler Temporario",
            "attributes": [
                {
                    "group_sub": "label",
                    "country": "ar",
                    "key_legacy": "electricity",
                    "group_subtype": "services",
                    "id": "electricity",
                    "label": "Electricidad",
                    "locale": "es_AR",
                    "type": "bool",
                    "group": "propertyAttribute",
                    "status": true
                },
                {
                    "group_sub": "label",
                    "country": "ar",
                    "key_legacy": "grill",
                    "group_subtype": "ammenities",
                    "id": "grill",
                    "label": "Parrilla",
                    "locale": "es_AR",
                    "type": "bool",
                    "group": "propertyAttribute",
                    "status": true
                },
                {
                    "group_sub": "label",
                    "country": "ar",
                    "key_legacy": "laundryMachine",
                    "group_subtype": "ammenities",
                    "id": "laundry-machine",
                    "label": "Lavarropas",
                    "locale": "es_AR",
                    "type": "bool",
                    "group": "propertyAttribute",
                    "status": true
                },
                {
                    "group_sub": "label",
                    "country": "ar",
                    "key_legacy": "professionalAvailable",
                    "group_subtype": "extras",
                    "id": "professional-available",
                    "label": "Apto profesional",
                    "locale": "es_AR",
                    "type": "bool",
                    "group": "propertyAttribute",
                    "status": true
                },
                {
                    "group_sub": "label",
                    "country": "ar",
                    "key_legacy": "hasSecurity",
                    "group_subtype": "services",
                    "id": "security",
                    "label": "Seguridad",
                    "locale": "es_AR",
                    "type": "bool",
                    "group": "propertyAttribute",
                    "status": true
                },
                {
                    "group_sub": "label",
                    "country": "ar",
                    "key_legacy": "sewers",
                    "group_subtype": "services",
                    "id": "sewers",
                    "label": "Cloacas",
                    "locale": "es_AR",
                    "type": "bool",
                    "group": "propertyAttribute",
                    "status": true
                }
            ],
    }
  ]
}