Mapaprop
PROD

Este webservice obtém imóveis do banco de dados. Você pode recuperar até 500 registros por chamada (há um limite). Use-o apenas até recuperar a lista completa de imóveis. Após isso, use get-delta como processo diário.

Informações do recurso
AutenticaçãoObrigatória
Método HTTPGET
RespostaJSON
Versão1

URL do recurso

https://mapaprop.app/api/action/feed-v1/get-properties

Parâmetros

ChaveTipoObrigatórioDescrição
countrystringsimCódigo ISO do país. Constantes
typesstringsimValores separados por vírgula dos tipos de imóvel. Constantes
operationsstringsimValores separados por vírgula das operações. Constantes
fromintsimNúmero do registro inicial.
tointsimNúmero do registro final. A diferença entre from e to não pode ultrapassar 500.
localestringnãoCódigo ISO de país que representa o locale para traduzir os textos. Constantes

Exemplo de código

GET /api/action/feed-v1/get-properties?country=AR&types=1,3,18&operations=sale,temp&from=1000&to=1500 HTTP/1.1
Host: mapaprop.app
Content-Type: application/x-www-form-urlencoded
Content-Length: 0
Authorization: Bearer {access_token}

Resposta

Um array de imóveis com a seguinte estrutura.

ObjetoCampoTipoObrigatórioDescrição
PropertyidstringsimO ID do imóvel gerado pelo sistema (hash)
propertyCodestringsimUm ID definido pelo cliente
typestringsimA descrição traduzida do tipo de imóvel. Constantes.
typeCodeintsimID numérico do tipo de imóvel. Constantes.
propertyTypestringsimA descrição traduzida do tipo de imóvel. Constantes.
operationstringsimA descrição traduzida da operação. Constantes.
operationCodeintsimO ID numérico da operação. Constantes
propertyOperationstringsimA descrição traduzida da operação. Constantes.
urlstringsimA URL em memudoya.com ou no site do cliente.
titlestringsimTítulo principal do imóvel. Geralmente inserido pelo cliente.
descriptionstringsimDescrição gerada automaticamente com as características do imóvel.
priceintsimPreço do imóvel
expensesintnãoValor do condomínio mensal
currencystringsimDescrição ISO da moeda do valor do imóvel. Constantes.
builtAreaintnãoÁrea construída total. Geralmente em metros quadrados.
totalAreaintnãoÁrea total do terreno. Geralmente em metros quadrados.
occupancyintnãoNúmero de ocupantes permitidos pelo proprietário em caso de locação temporária.
bedroomsintnãoNúmero de dormitórios do imóvel
ambiencesintnãoNúmero de ambientes do imóvel
bathroomsintnãoNúmero de banheiros do imóvel
yearsOldintnãoIdade do imóvel em anos
totalFloorsintnãoNúmero de andares do edifício
apartmentsPerFloorintnãoNúmero de apartamentos por andar
floorsintnãoNúmero de andares do imóvel
orientationStringnãoOrientação do imóvel
ubicationStringnãoPosição do imóvel no terreno
balconyTypeStringnãoTipo de varanda do apartamento
lastUpdateStringsimData no formato ISO 8601 UTC com a última atualização do imóvel
paymentPeriodStringnãoDescrição do período de pagamento. Apenas para locações temporárias.
locationLocationsimInformações de localização do imóvel
imagesArray de stringsnãoArray de imagens do imóvel
videosArray de jsonnãoVídeos do imóvel (URL ou embed)
agencyAgencysimObjeto que representa a imobiliária que publica o imóvel
amenitiesArray de stringssimArray com etiquetas de comodidades do imóvel. Constantes
LocationlatitudestringsimLatitude do imóvel
longitudestringsimLongitude do imóvel
countrystringsimPaís onde o imóvel está localizado
statestringsimEstado onde o imóvel está localizado
citystringsimCidade onde o imóvel está localizado
addressstringsimEndereço onde o imóvel está localizado
zipCodestringsimCEP da localização do imóvel
AgencyidstringsimO ID da imobiliária
namestringsimO nome da imobiliária
addressstringsimO endereço da imobiliária
phonestringsimO número de telefone da imobiliária
mobilestringnãoO número de celular em formato universal
emailstringsimO email da imobiliária (conforme o serviço contratado)
logostringsimUma URL com o logotipo da imobiliária
attributesattributesArray de atributos jsonnãoTodos os atributos do imóvel
descriptionFormatteddescriptionstringnãoDescrição com nova formatação que aceita quebras de linha

Exemplo de código

[
    {
        "id": "350ebf8f7d7be42bf18ad73b59005c54",
        "propertyCode": "2485-635896",
        "type": "Casa",
        "typeCode": 1,
        "propertyType": "Casa",
        "operation": "Venta",
        "operationCode": 1,
        "propertyOperation": "Venta",
        "url": "http://gonzalezprops.com/propiedades/id=3223923",
        "title": "Propiedad con vista al mar, excelente oportunidad!",
        "description": "CODIGO: 1520- MYR1504 ubicado en: a 0.2km de la ciudad - Campo en Venta en Lobos, Buenos Aires. Publicado a través de Mapaprop",
        "price": "180000",
        "expenses": "150",
        "lastUpdate": "2014-01-24T10:30:27Z",
        "paymentPeriod": "weekly",
        "currency": "USD",
        "builtArea": 180,
        "totalArea": 220,
        "occupancy": 5,
        "bedrooms": 4,
        "ambiences": 5,
        "bathrooms": 1,
        "yearsOld": 50,
        "totalFloors": 8,
        "apartmentsPerFloor": 5,
        "floors": 1,
        "orientation": "NORESTE",
        "ubication": "Frente",
        "balconyType": "Corrido",
        "location": {
            "latitude": "-33.23932932",
            "longitude": "-59.30203230",
            "country": "Argentina",
            "state": "Buenos Aires",
            "city": "Mar del Plata",
            "address": "De la Fuente 3993",
            "zipcode": "1661"
        },
        "images": [
            "http://gestion.mapaprop.com/images/photos/1520/49998/343298.jpg",
            "http://gestion.mapaprop.com/images/photos/1520/49998/5155.jpg",
            "http://gestion.mapaprop.com/images/photos/1520/49998/23235.jpg"
        ],
        "videos": [
        {
            "custId": 1,
            "description": "asdasdsadadasd",
            "videoId": 7252,
            "source": "https://www.youtube.com/shorts/DV5mG3XGPZU",
            "propertyId": 256854
        },
        {
            "custId": 1,
            "description": "asdasdsadadasd",
            "videoId": 7253,
            "source": "https://www.youtube.com/watch?v=gLcP6qqulhA&ab_channel=NovalProperties",
            "propertyId": 256854
        },
        {
            "custId": 1,
            "description": "asdasdsadadasd",
            "videoId": 7254,
            "source": "<iframe width=\"560\" height=\"315\" src=\"https://www.youtube.com/embed/gLcP6qqulhA?si=CpKaYWLYZXXh4zyP\" title=\"YouTube video player\" frameborder=\"0\" allow=\"accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share\" referrerpolicy=\"strict-origin-when-cross-origin\" allowfullscreen></iframe>",
            "propertyId": 256854
        },
        {
            "custId": 1,
            "description": "dasdsadsss",
            "videoId": 7258,
            "source": "https://my.matterport.com/show?play=1&lang=en-US&m=CmhKN1eSdqR",
            "propertyId": 256854
        }
    ],
        "agency": {
            "id": "8441239688441236",
            "name": "Gonzalez Propiedades",
            "address": "Gorostiaga 9393",
            "phone": "666 7114",
            "mobile": "541184485145",
            "email": "r.gonzalez@gonzalezprops.com",
            "logo": "http://gonzalezprops.com/img/logo.png"
        },
        "amenities": [
            "Patio",
            "Garage",
            "Aire acondicionado",
            "Linea telefonica",
            "Pileta",
            "Seguridad"
        ],
        "descriptionFormatted": "CODIGO: 2544-Chañ ubicado en: Av. Los Chañares -  Publicado por: FÉLIX RUIZ. Terreno en Venta en Oro Verde, Paraná, Entre Ríos. El precio es de USD 17000 null. La superficie total es de 300 metros cuadrados. Servicios en el Terreno: . El Terreno cuenta con: Cochera. . Comodidades: Electricidad | Parrilla | Lavarropas | Apto profesional | Seguridad | Cloacas |  Publicado a través de Mapaprop",
        "attributes": [
                      {
                        "group_sub": "propertyType",
                        "country": "ar",
                        "key_legacy": "1",
                        "id": "apartment",
                        "label": "Departamento",
                        "locale": "es_AR",
                        "type": "string",
                        "group": "type"
                      },
                      {
                        "group_sub": "waterHeaterType",
                        "country": "ar",
                        "key_legacy": "1",
                        "id": "waterHeaterCalefon",
                        "label": "Agua caliente Calefón",
                        "locale": "es_AR",
                        "type": "list",
                        "value": "1",
                        "group": "propertyAttribute"
                      },
                      {
                        "group_sub": "heatingType",
                        "country": "ar",
                        "key_legacy": "1",
                        "id": "heatingCentral",
                        "label": "Calefacción Central",
                        "locale": "es_AR",
                        "type": "list",
                        "value": "1",
                        "group": "propertyAttribute"
                      },
                      {
                        "group_sub": "airConditonerType",
                        "country": "ar",
                        "key_legacy": "1",
                        "id": "airConditonerTypeCentral",
                        "label": "Aire acondicionado Central",
                        "locale": "es_AR",
                        "type": "list",
                        "value": "1",
                        "group": "propertyAttribute"
                      },
              {
                        "group_sub": "garageType",
                        "country": "cl",
                        "number": 3,
                        "key_legacy": "2",
                        "id": "garageCovered",
                        "label": "Garaje cubierto",
                        "locale": "es_CL",
                        "type": "list",
                        "value": "2",
                        "group": "propertyAttribute"
                      },
            {
                "group_sub": "label",
                "country": "ar",
                "group_subtype": "services",
                "id": "electricity",
                "label": "Electricidad",
                "locale": "es_AR",
                "type": "bool",
                "group": "propertyAttribute",
                "status": true
            },
            {
                "group_sub": "label",
                "country": "ar",
                "group_subtype": "ammenities",
                "id": "grill",
                "label": "Parrilla",
                "locale": "es_AR",
                "type": "bool",
                "group": "propertyAttribute",
                "status": true
            },
            {
                "group_sub": "label",
                "country": "ar",
                "group_subtype": "ammenities",
                "id": "laundry-machine",
                "label": "Lavarropas",
                "locale": "es_AR",
                "type": "bool",
                "group": "propertyAttribute",
                "status": true
            },
            {
                "group_sub": "label",
                "country": "ar",
                "group_subtype": "extras",
                "id": "professional-available",
                "label": "Apto profesional",
                "locale": "es_AR",
                "type": "bool",
                "group": "propertyAttribute",
                "status": true
            },
            {
                "group_sub": "label",
                "country": "ar",
                "group_subtype": "services",
                "id": "security",
                "label": "Seguridad",
                "locale": "es_AR",
                "type": "bool",
                "group": "propertyAttribute",
                "status": true
            },
            {
                "group_sub": "label",
                "country": "ar",
                "group_subtype": "services",
                "id": "sewers",
                "label": "Cloacas",
                "locale": "es_AR",
                "type": "bool",
                "group": "propertyAttribute",
                "status": true
            }
        ]
    }
]

Exemplos de comodidades

A lista a seguir é um exemplo de algumas comodidades. Trate-as como etiquetas. Esta não é a lista completa do sistema.

Valor originalEspanhol AR
heatingTypeCalefacción
airConditionerTypeAire acondicionado
securityBoxCaja de seguridad
alarmAlarma
janitorEncargado de edificio
telephoneLineLinea telefonica
cableIncludedCable incluido
frontGardenJardin al frente
hasSecuritySeguridad privada
terraceTerraza
suiteDormitorio en suite
grillParrilla
hasStorageBaulera

Outros métodos