Imóveis Ibéricos API

API ID 14784

Listagens de propriedades ao vivo para Portugal Espanha Itália e França do Idealista Imovirtual Fotocasa e Casa Sapo em uma API JSON com detalhes da listagem estatísticas de preço por m2 rendimento de aluguel avaliação e um localizador de negócios

Documentação da API

Endpoints

Requisição
Busca todos os portais de um país de uma só vez e retorna uma lista mesclada de anúncios com preço, área, quartos, localização e agência Verifique o array de fontes para erros por fonte
Endpoint ID: 38306
GET https://zylalabs.com/api/14784/iberian+real+estate+api/38306/search+listings
PARÂMETROS DE ENTRADA

Pesquisar Anúncios — Recursos do endpoint

Objeto Descrição
location Opcional Known city or area name such as lisboa, cascais, madrid or barcelona.
type Opcional Transaction type: sale or rent. Default is sale.
propertyType Opcional Property type: apartment or house. Default is apartment.
minPrice Opcional Minimum price in EUR, or monthly rent when type is rent.
maxPrice Opcional Maximum price in EUR, or monthly rent when type is rent.
bedrooms Opcional Number of bedrooms. A value of 6 means 6 or more.
country Opcional Country code: pt, es, it or fr. Default is pt.
source Opcional Optional comma separated sources such as imovirtual,casasapo.
page Opcional One based page number, default 1.

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

location
type
propertyType
minPrice
maxPrice
bedrooms
country
source
page
RESPOSTA DE EXEMPLO DA API
JSON
{
    "data": {
        "count": 37,
        "listings": [
            {
                "agency": {
                    "name": "Tetus - Soluções Imobiliárias",
                    "type": "AGENCY"
                },
                "areaSquareMeters": 62,
                "bedrooms": 1,
                "id": "imovirtual:apartamento-t1-com-varanda-e-parqueamento-avenidas-novas-ID1iZKm",
                "isPrivateOwner": false,
                "location": {
                    "council": "Lisboa",
                    "district": "Lisboa",
                    "fullName": "Entrecampos, Avenidas Novas, Lisboa, Lisboa",
                    "neighborhood": "Entrecampos",
                    "parish": "Avenidas Novas"
                },
                "postedAt": "2026-10-09T14:46:28Z",
                "price": {
                    "amount": 480000,
                    "currency": "EUR"
                },
                "pricePerSquareMeter": {
                    "amount": 7741.94,
                    "currency": "EUR"
                },
                "propertyType": "apartment",
                "source": "imovirtual",
                "title": "Apartamento T1, com varanda e parqueamento - Avenidas Novas",
                "transaction": "sale",
                "url": "https://www.imovirtual.com/pt/anuncio/apartamento-t1-com-varanda-e-parqueamento-avenidas-novas-ID1iZKm"
            }
        ],
        "query": {
            "bedrooms": null,
            "country": "pt",
            "location": "lisboa",
            "maxPrice": null,
            "minPrice": null,
            "page": 1,
            "propertyType": "apartment",
            "type": "sale"
        },
        "sources": [
            {
                "count": 37,
                "error": null,
                "source": "imovirtual"
            }
        ]
    },
    "error": null,
    "message": "Found 37 listing(s) across 2/3 source(s)."
}
Pesquisar Anúncios — TRECHOS DE CÓDIGO

curl --location --request GET 'https://zylalabs.com/api/14784/iberian+real+estate+api/38306/search+listings?location=lisboa&type=sale&propertyType=apartment&country=pt&page=1' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Requisição
Os mesmos filtros que Listagens de Pesquisa, mas retornam o preço médio, mediano, mínimo e máximo e o preço por m² para a página de pesquisa atual
Endpoint ID: 38307
GET https://zylalabs.com/api/14784/iberian+real+estate+api/38307/search+summary
PARÂMETROS DE ENTRADA

Resumo da Busca — Recursos do endpoint

Objeto Descrição
location Opcional Known city or area name such as lisboa, cascais, madrid or barcelona.
type Opcional Transaction type: sale or rent. Default is sale.
propertyType Opcional Property type: apartment or house. Default is apartment.
minPrice Opcional Minimum price in EUR, or monthly rent when type is rent.
maxPrice Opcional Maximum price in EUR, or monthly rent when type is rent.
bedrooms Opcional Number of bedrooms. A value of 6 means 6 or more.
country Opcional Country code: pt, es, it or fr. Default is pt.
source Opcional Optional comma separated sources such as imovirtual,casasapo.
page Opcional One based page number, default 1.

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

location
type
propertyType
minPrice
maxPrice
bedrooms
country
source
page
RESPOSTA DE EXEMPLO DA API
JSON
{
    "data": {
        "avgPrice": 1016371.64,
        "avgPricePerSquareMeter": 7226.98,
        "count": 67,
        "maxPrice": 2600000,
        "medianPricePerSquareMeter": 6612.9,
        "minPrice": 315000,
        "pricedListings": 67,
        "query": {
            "bedrooms": null,
            "country": "pt",
            "location": "lisboa",
            "maxPrice": null,
            "minPrice": null,
            "page": 1,
            "propertyType": "apartment",
            "type": "sale"
        },
        "sampleSize": 67,
        "scope": "current-search-page",
        "sources": [
            {
                "count": 37,
                "error": null,
                "source": "imovirtual"
            }
        ]
    },
    "error": null,
    "message": "Summary of the current search page."
}
Resumo da Busca — TRECHOS DE CÓDIGO

curl --location --request GET 'https://zylalabs.com/api/14784/iberian+real+estate+api/38307/search+summary?location=lisboa&type=sale&propertyType=apartment&country=pt&page=1' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Requisição
Mesmos filtros que Listagens de Pesquisa, mas retorna contagens de valores observados por fonte, tipo de propriedade, transação e quartos para a página atual
Endpoint ID: 38308
GET https://zylalabs.com/api/14784/iberian+real+estate+api/38308/search+facets
PARÂMETROS DE ENTRADA

Facetas de Pesquisa — Recursos do endpoint

Objeto Descrição
location Opcional Known city or area name such as lisboa, cascais, madrid or barcelona.
type Opcional Transaction type: sale or rent. Default is sale.
propertyType Opcional Property type: apartment or house. Default is apartment.
minPrice Opcional Minimum price in EUR, or monthly rent when type is rent.
maxPrice Opcional Maximum price in EUR, or monthly rent when type is rent.
bedrooms Opcional Number of bedrooms. A value of 6 means 6 or more.
country Opcional Country code: pt, es, it or fr. Default is pt.
source Opcional Optional comma separated sources such as imovirtual,casasapo.
page Opcional One based page number, default 1.

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

location
type
propertyType
minPrice
maxPrice
bedrooms
country
source
page
RESPOSTA DE EXEMPLO DA API
JSON
{
    "data": {
        "count": 67,
        "facets": {
            "bedrooms": [
                {
                    "count": 11,
                    "value": 1
                }
            ],
            "propertyType": [
                {
                    "count": 67,
                    "value": "apartment"
                }
            ],
            "source": [
                {
                    "count": 37,
                    "value": "imovirtual"
                }
            ],
            "transaction": [
                {
                    "count": 67,
                    "value": "sale"
                }
            ]
        },
        "query": {
            "bedrooms": null,
            "country": "pt",
            "location": "lisboa",
            "maxPrice": null,
            "minPrice": null,
            "page": 1,
            "propertyType": "apartment",
            "type": "sale"
        },
        "scope": "current-search-page",
        "sources": [
            {
                "count": 37,
                "error": null,
                "source": "imovirtual"
            }
        ]
    },
    "error": null,
    "message": "Observed values in the current search page."
}
Facetas de Pesquisa — TRECHOS DE CÓDIGO

curl --location --request GET 'https://zylalabs.com/api/14784/iberian+real+estate+api/38308/search+facets?location=lisboa&type=sale&propertyType=apartment&country=pt&page=1' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Requisição
Lista quais fontes estão disponíveis por país as seções de detalhes que existem e o tamanho máximo do lote
Endpoint ID: 38309
GET https://zylalabs.com/api/14784/iberian+real+estate+api/38309/listing+sources
PARÂMETROS DE ENTRADA

Fontes de Listagem — Recursos do endpoint

Objeto Descrição
country Opcional Country code: pt, es, it or fr. Default is pt.

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

country
RESPOSTA DE EXEMPLO DA API
JSON
{
    "data": {
        "countries": {
            "es": [
                "fotocasa",
                "idealista"
            ]
        },
        "maxBatchSize": 20,
        "sections": [
            "media",
            "features",
            "location",
            "advertiser",
            "pricing"
        ]
    },
    "error": null,
    "message": "Listing source capabilities."
}
Fontes de Listagem — TRECHOS DE CÓDIGO

curl --location --request GET 'https://zylalabs.com/api/14784/iberian+real+estate+api/38309/listing+sources?country=es' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Requisição
Detalhes completos para um anúncio pelo id retornado da busca descrição imagens características classificação de energia anunciante coordenadas e mais
Endpoint ID: 38310
GET https://zylalabs.com/api/14784/iberian+real+estate+api/38310/listing+detail
PARÂMETROS DE ENTRADA

Solicitações gratuitas de teste restantes: 3 de 3.

RESPOSTA DE EXEMPLO DA API
JSON
{
    "data": {
        "address": {
            "country": null,
            "postalCode": null,
            "street": "Rua Soeiro Pereira Gomes"
        },
        "advertiser": {
            "name": "Tetus - Soluções Imobiliárias",
            "url": "https://www.imovirtual.com/pt/empresas/agencias-imobiliarias/tetus-solucoes-imobiliarias-ID1087"
        },
        "agency": {
            "name": "Tetus - Soluções Imobiliárias",
            "type": "agency"
        },
        "amenities": [
            "lift"
        ],
        "areaSquareMeters": 62,
        "bathrooms": 1,
        "bedrooms": 1,
        "characteristics": {
            "building_type": "block",
            "construction_status": "ready_to_use",
            "energy_certificate": "c",
            "heating": "other",
            "m": "62",
            "market": "secondary",
            "price": "480000",
            "price_per_m": "7741.94",
            "rooms_num": "2"
        },
        "condition": "ready_to_use",
        "constructionYear": null,
        "coordinates": {
            "isExact": null,
            "latitude": 38.74468,
            "longitude": -9.15954
        },
        "description": "Apartamento T1, no piso 6 de um prédio composto por apartamentos com varandas e parqueamentos, com boas áreas de acesso comum.",
        "energy": {
            "certificateUrl": null,
            "consumption": null,
            "emissions": null,
            "emissionsRating": null,
            "rating": "C"
        },
        "featureLabels": {
            "m": "62 m²",
            "price": "480 000 €",
            "price_per_m": "7741,94 €/m²",
            "rooms_num": "2"
        },
        "floor": null,
        "hasElevator": true,
        "hasVirtualTour": null,
        "id": "imovirtual:apartamento-t1-com-varanda-e-parqueamento-avenidas-novas-ID1iZKm",
        "images": [
            "https://ireland.apollo.olxcdn.com/v1/files/eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJmbiI6Im41a2pwbjM2OWE4ZS1FQ09TWVNURU0iLCJ3IjpbeyJmbiI6IjY5bmxwYTdlY3FtNzEtQVBUIiwicyI6IjE2IiwiYSI6IjAiLCJwIjoiMTAsLTEwIn1dfQ.w11RnrgZ1J..."
        ],
        "isFurnished": null,
        "isNewConstruction": null,
        "isPrivateOwner": false,
        "isTemporaryRental": null,
        "location": {
            "council": "Lisboa",
            "district": "Lisboa",
            "fullName": "Entrecampos, Avenidas Novas, Lisboa, Lisboa",
            "neighborhood": "Entrecampos",
            "parish": "Avenidas Novas"
        },
        "orientation": null,
        "plotAreaSquareMeters": null,
        "postedAt": "2026-10-09T14:46:28Z",
        "price": {
            "amount": 480000,
            "currency": "EUR"
        },
        "pricePerSquareMeter": {
            "amount": 7741.94,
            "currency": "EUR"
        },
        "priceReduction": null,
        "propertyAge": null,
        "propertySubtype": null,
        "propertyType": "apartment",
        "reference": "18590",
        "source": "imovirtual",
        "title": "Apartamento T1, com varanda e parqueamento - Avenidas Novas",
        "totalFloors": null,
        "transaction": "sale",
        "updatedAt": "2026-11-09T11:53:37.000Z",
        "url": "https://www.imovirtual.com/pt/anuncio/apartamento-t1-com-varanda-e-parqueamento-avenidas-novas-ID1iZKm",
        "usableAreaSquareMeters": null
    },
    "error": null,
    "message": "Listing found."
}
Detalhe do Anúncio — TRECHOS DE CÓDIGO

curl --location --request GET 'https://zylalabs.com/api/14784/iberian+real+estate+api/38310/listing+detail&id=Required' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Requisição
Imagens itens de mídia digitados e disponibilidade de tour virtual para uma listagem pelo id retornado da busca
Endpoint ID: 38311
GET https://zylalabs.com/api/14784/iberian+real+estate+api/38311/listing+media
PARÂMETROS DE ENTRADA

Solicitações gratuitas de teste restantes: 3 de 3.

RESPOSTA DE EXEMPLO DA API
JSON
{
    "data": {
        "hasVirtualTour": null,
        "id": "imovirtual:apartamento-t1-com-varanda-e-parqueamento-avenidas-novas-ID1iZKm",
        "images": [
            "https://ireland.apollo.olxcdn.com/v1/files/eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJmbiI6Im41a2pwbjM2OWE4ZS1FQ09TWVNURU0iLCJ3IjpbeyJmbiI6IjY5bmxwYTdlY3FtNzEtQVBUIiwicyI6IjE2IiwiYSI6IjAiLCJwIjoiMTAsLTEwIn1dfQ.w11RnrgZ1J..."
        ],
        "media": [
            {
                "type": "image",
                "url": "https://ireland.apollo.olxcdn.com/v1/files/eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJmbiI6Im41a2pwbjM2OWE4ZS1FQ09TWVNURU0iLCJ3IjpbeyJmbiI6IjY5bmxwYTdlY3FtNzEtQVBUIiwicyI6IjE2IiwiYSI6IjAiLCJwIjoiMTAsLTEwIn1dfQ.w11RnrgZ1J..."
            }
        ],
        "source": "imovirtual"
    },
    "error": null,
    "message": "Listing media."
}
Listagem de Mídia — TRECHOS DE CÓDIGO

curl --location --request GET 'https://zylalabs.com/api/14784/iberian+real+estate+api/38311/listing+media&id=Required' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Requisição
Características do imóvel comodidades classificação de energia e características da fonte bruta para uma listagem pelo id retornado da pesquisa
Endpoint ID: 38312
GET https://zylalabs.com/api/14784/iberian+real+estate+api/38312/listing+features
PARÂMETROS DE ENTRADA

Solicitações gratuitas de teste restantes: 3 de 3.

RESPOSTA DE EXEMPLO DA API
JSON
{
    "data": {
        "amenities": [
            "lift"
        ],
        "areaSquareMeters": 62,
        "bathrooms": 1,
        "bedrooms": 1,
        "characteristics": {
            "building_type": "block",
            "construction_status": "ready_to_use",
            "energy_certificate": "c",
            "heating": "other",
            "m": "62",
            "market": "secondary",
            "price": "480000",
            "price_per_m": "7741.94",
            "rooms_num": "2"
        },
        "condition": "ready_to_use",
        "constructionYear": null,
        "energy": {
            "certificateUrl": null,
            "consumption": null,
            "emissions": null,
            "emissionsRating": null,
            "rating": "C"
        },
        "featureLabels": {
            "m": "62 m²",
            "price": "480 000 €",
            "price_per_m": "7741,94 €/m²",
            "rooms_num": "2"
        },
        "floor": null,
        "hasElevator": true,
        "id": "imovirtual:apartamento-t1-com-varanda-e-parqueamento-avenidas-novas-ID1iZKm",
        "isFurnished": null,
        "isNewConstruction": null,
        "isTemporaryRental": null,
        "orientation": null,
        "plotAreaSquareMeters": null,
        "propertyAge": null,
        "propertySubtype": null,
        "propertyType": "apartment",
        "source": "imovirtual",
        "totalFloors": null,
        "usableAreaSquareMeters": null
    },
    "error": null,
    "message": "Listing features."
}
Listando Recursos — TRECHOS DE CÓDIGO

curl --location --request GET 'https://zylalabs.com/api/14784/iberian+real+estate+api/38312/listing+features&id=Required' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Requisição
Nomes de locais, endereço da rua e coordenadas para uma listagem, pelo id retornado da busca
Endpoint ID: 38313
GET https://zylalabs.com/api/14784/iberian+real+estate+api/38313/listing+location
PARÂMETROS DE ENTRADA

Solicitações gratuitas de teste restantes: 3 de 3.

RESPOSTA DE EXEMPLO DA API
JSON
{
    "data": {
        "address": {
            "country": null,
            "postalCode": null,
            "street": "Rua Soeiro Pereira Gomes"
        },
        "coordinates": {
            "isExact": null,
            "latitude": 38.74468,
            "longitude": -9.15954
        },
        "id": "imovirtual:apartamento-t1-com-varanda-e-parqueamento-avenidas-novas-ID1iZKm",
        "location": {
            "council": "Lisboa",
            "district": "Lisboa",
            "fullName": "Entrecampos, Avenidas Novas, Lisboa, Lisboa",
            "neighborhood": "Entrecampos",
            "parish": "Avenidas Novas"
        },
        "source": "imovirtual"
    },
    "error": null,
    "message": "Listing location."
}
Localização da Lista — TRECHOS DE CÓDIGO

curl --location --request GET 'https://zylalabs.com/api/14784/iberian+real+estate+api/38313/listing+location&id=Required' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Requisição
Detalhes da agência ou anunciante sinalização de proprietário privado e referência de listagem para uma listagem pelo id retornado da busca
Endpoint ID: 38314
GET https://zylalabs.com/api/14784/iberian+real+estate+api/38314/listing+advertiser
PARÂMETROS DE ENTRADA

Solicitações gratuitas de teste restantes: 3 de 3.

RESPOSTA DE EXEMPLO DA API
JSON
{
    "data": {
        "advertiser": {
            "name": "Tetus - Soluções Imobiliárias",
            "url": "https://www.imovirtual.com/pt/empresas/agencias-imobiliarias/tetus-solucoes-imobiliarias-ID1087"
        },
        "agency": {
            "name": "Tetus - Soluções Imobiliárias",
            "type": "agency"
        },
        "id": "imovirtual:apartamento-t1-com-varanda-e-parqueamento-avenidas-novas-ID1iZKm",
        "isPrivateOwner": false,
        "reference": "18590",
        "source": "imovirtual"
    },
    "error": null,
    "message": "Listing advertiser."
}
Anunciante de Listagem — TRECHOS DE CÓDIGO

curl --location --request GET 'https://zylalabs.com/api/14784/iberian+real+estate+api/38314/listing+advertiser&id=Required' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Requisição
Preço preço por m2 redução de preço e datas de postagem e atualização para uma listagem pelo id retornado da busca
Endpoint ID: 38315
GET https://zylalabs.com/api/14784/iberian+real+estate+api/38315/listing+pricing
PARÂMETROS DE ENTRADA

Solicitações gratuitas de teste restantes: 3 de 3.

RESPOSTA DE EXEMPLO DA API
JSON
{
    "data": {
        "id": "imovirtual:apartamento-t1-com-varanda-e-parqueamento-avenidas-novas-ID1iZKm",
        "postedAt": "2026-10-09T14:46:28Z",
        "price": {
            "amount": 480000,
            "currency": "EUR"
        },
        "pricePerSquareMeter": {
            "amount": 7741.94,
            "currency": "EUR"
        },
        "priceReduction": null,
        "source": "imovirtual",
        "transaction": "sale",
        "updatedAt": "2026-11-09T11:53:37.000Z"
    },
    "error": null,
    "message": "Listing pricing."
}
Listagem de Preços — TRECHOS DE CÓDIGO

curl --location --request GET 'https://zylalabs.com/api/14784/iberian+real+estate+api/38315/listing+pricing&id=Required' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Requisição
Preço médio e mediano atual por m2 para comprar e alugar em uma área com uma estimativa de rendimento bruto de aluguel calculada ao vivo a partir dos preços de pedido
Endpoint ID: 38316
GET https://zylalabs.com/api/14784/iberian+real+estate+api/38316/area+market+stats
PARÂMETROS DE ENTRADA

Estatísticas de Mercado da Área — Recursos do endpoint

Objeto Descrição
propertyType Opcional Property type: apartment or house. Default is apartment.
country Opcional Country code: pt, es, it or fr. Default is pt.
source Opcional Optional comma separated sources such as imovirtual,casasapo.
area Obrigatório

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

propertyType
country
source
RESPOSTA DE EXEMPLO DA API
JSON
{
    "data": {
        "area": "lisboa",
        "country": "pt",
        "grossRentalYieldPercent": 4.23,
        "propertyType": "apartment",
        "rent": {
            "avgPrice": 4014.96,
            "avgPricePerSquareMeter": 57.79,
            "maxPrice": 420000,
            "medianPricePerSquareMeter": 23.33,
            "minPrice": 630,
            "sampleSize": 199
        },
        "resolvedLocation": "lisboa/lisboa",
        "sale": {
            "avgPrice": 1074529.65,
            "avgPricePerSquareMeter": 7441.27,
            "maxPrice": 10000000,
            "medianPricePerSquareMeter": 6621.62,
            "minPrice": 270000,
            "sampleSize": 199
        },
        "sources": [
            {
                "error": null,
                "source": "imovirtual"
            }
        ]
    },
    "error": null,
    "message": "Area stats for \"lisboa\"."
}
Estatísticas de Mercado da Área — TRECHOS DE CÓDIGO

curl --location --request GET 'https://zylalabs.com/api/14784/iberian+real+estate+api/38316/area+market+stats?propertyType=apartment&country=pt&area=Required' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Requisição
Estima o preço de um imóvel a partir de anúncios comparáveis atualmente no mercado na mesma área com uma faixa de preço e um nível de confiança
Endpoint ID: 38317
GET https://zylalabs.com/api/14784/iberian+real+estate+api/38317/property+valuation
PARÂMETROS DE ENTRADA

Avaliação de Propriedade — Recursos do endpoint

Objeto Descrição
area Obrigatório Known city or area name such as lisboa or madrid.
areaSquareMeters Obrigatório Floor area of the property in square meters.
bedrooms Opcional Number of bedrooms. Optional, narrows the comparable set.
propertyType Opcional Property type: apartment or house. Default is apartment.
transaction Opcional Transaction type: sale or rent. Default is sale.
country Opcional Country code: pt, es, it or fr. Default is pt.
source Opcional Optional comma separated sources such as imovirtual,casasapo.

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

area
areaSquareMeters
bedrooms
propertyType
transaction
country
source
RESPOSTA DE EXEMPLO DA API
JSON
{
    "data": {
        "area": "lisboa",
        "areaMarket": {
            "rent": {
                "avgPrice": 4018.63,
                "avgPricePerSquareMeter": 57.84,
                "maxPrice": 420000,
                "medianPricePerSquareMeter": 23.33,
                "minPrice": 630,
                "sampleSize": 199
            },
            "sale": {
                "avgPrice": 1074529.65,
                "avgPricePerSquareMeter": 7441.27,
                "maxPrice": 10000000,
                "medianPricePerSquareMeter": 6621.62,
                "minPrice": 270000,
                "sampleSize": 199
            }
        },
        "country": "pt",
        "disclaimer": "Derived from currently listed asking prices for comparable units in the area; not an automated valuation model (AVM) and not a substitute for a professional appraisal.",
        "estimate": {
            "comparableCriteria": {
                "bedrooms": 2,
                "bedroomsMatched": true,
                "sizeWindowPercent": 30
            },
            "confidence": "high",
            "price": 520100,
            "pricePerSquareMeter": 6501.25,
            "priceRange": {
                "high": 620502,
                "low": 471689.2
            },
            "sampleSize": 34
        },
        "input": {
            "areaSquareMeters": 80,
            "bedrooms": 2
        },
        "method": "comparables-median-price-per-sqm",
        "propertyType": "apartment",
        "resolvedLocation": "lisboa/lisboa",
        "sources": [
            {
                "error": null,
                "source": "imovirtual"
            }
        ],
        "transaction": "sale"
    },
    "error": null,
    "message": "Estimated sale price: 520100 EUR (high confidence, 34 comparable(s))."
}
Avaliação de Propriedade — TRECHOS DE CÓDIGO

curl --location --request GET 'https://zylalabs.com/api/14784/iberian+real+estate+api/38317/property+valuation?area=lisboa&areaSquareMeters=80&bedrooms=2&propertyType=apartment&transaction=sale&country=pt' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Requisição
Classifica os anúncios atuais de uma área pela distância abaixo do preço mediano da área por m2 de cada um, melhor pontuação primeiro
Endpoint ID: 38318
GET https://zylalabs.com/api/14784/iberian+real+estate+api/38318/deal+finder
PARÂMETROS DE ENTRADA

Localizador de Ofertas — Recursos do endpoint

Objeto Descrição
propertyType Opcional Property type: apartment or house. Default is apartment.
transaction Opcional Transaction type: sale or rent. Default is sale.
country Opcional Country code: pt, es, it or fr. Default is pt.
source Opcional Optional comma separated sources such as imovirtual,casasapo.
limit Opcional How many deals to return, from 1 to 50. Default is 10.
area Obrigatório

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

propertyType
transaction
country
source
limit
RESPOSTA DE EXEMPLO DA API
JSON
{
    "data": {
        "area": "lisboa",
        "benchmark": {
            "avgPrice": 1074529.65,
            "avgPricePerSquareMeter": 7441.27,
            "maxPrice": 10000000,
            "medianPricePerSquareMeter": 6621.62,
            "minPrice": 270000,
            "sampleSize": 199
        },
        "count": 3,
        "country": "pt",
        "deals": [
            {
                "agency": {
                    "name": "Century21 Dreamline",
                    "type": "AGENCY"
                },
                "areaSquareMeters": 2160,
                "bedrooms": 0,
                "benchmarkPricePerSquareMeter": 6621.62,
                "dealScorePercent": 69.94,
                "id": "imovirtual:oportunidade-para-investidores-no-coracao-de-lisboa-ID1hxZd",
                "isPrivateOwner": false,
                "location": {
                    "council": "Lisboa",
                    "district": "Lisboa",
                    "fullName": "Alto de São João - Alto do Varejão, Penha de França, Lisboa, Lisboa",
                    "neighborhood": "Alto de São João - Alto do Varejão",
                    "parish": "Penha de França"
                },
                "postedAt": "2025-11-18T10:39:28Z",
                "price": {
                    "amount": 4300000,
                    "currency": "EUR"
                },
                "pricePerSquareMeter": {
                    "amount": 1990.74,
                    "currency": "EUR"
                },
                "propertyType": "apartment",
                "source": "imovirtual",
                "title": "OPORTUNIDADE PARA INVESTIDORES NO CORAÇÃO DE LISBOA",
                "transaction": "sale",
                "url": "https://www.imovirtual.com/pt/anuncio/oportunidade-para-investidores-no-coracao-de-lisboa-ID1hxZd"
            }
        ],
        "disclaimer": "A heuristic ranking against currently listed asking prices in the area, not a predictor of achieved sale price or an indicator that a listing is a scam, overpriced for a hidden reason, etc.",
        "method": "percent-below-area-median-price-per-sqm",
        "propertyType": "apartment",
        "resolvedLocation": "lisboa/lisboa",
        "scoredListings": 199,
        "sources": [
            {
                "error": null,
                "source": "imovirtual"
            }
        ],
        "transaction": "sale",
        "unscored": 0
    },
    "error": null,
    "message": "Found 3 potential deal(s) in \"lisboa\" out of 199 scored listing(s)."
}
Localizador de Ofertas — TRECHOS DE CÓDIGO

curl --location --request GET 'https://zylalabs.com/api/14784/iberian+real+estate+api/38318/deal+finder?propertyType=apartment&transaction=sale&country=pt&limit=3&area=Required' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Requisição
Busca Idealista diretamente e retorna listagens normalizadas com paginação para Portugal Espanha Itália ou França
Endpoint ID: 38319
GET https://zylalabs.com/api/14784/iberian+real+estate+api/38319/idealista+search
PARÂMETROS DE ENTRADA

Idealista Busca — Recursos do endpoint

Objeto Descrição
country Opcional Country code: pt, es, it or fr. Default is pt.
location Opcional Known city or area name such as braga, lisboa or madrid.
type Opcional Transaction type: sale or rent. Default is sale.
propertyType Opcional Property type: apartment or house. Default is apartment.
minPrice Opcional Minimum price in EUR, or monthly rent when type is rent.
maxPrice Opcional Maximum price in EUR, or monthly rent when type is rent.
bedrooms Opcional Number of bedrooms. A value of 6 means 6 or more.
page Opcional One based page number, default 1.

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

country
location
type
propertyType
minPrice
maxPrice
bedrooms
page
RESPOSTA DE EXEMPLO DA API
JSON
{
    "data": {
        "listings": [
            {
                "agency": {
                    "name": "Tânia Cruz - RE/MAX",
                    "type": "agency"
                },
                "areaSquareMeters": 82,
                "bedrooms": 2,
                "id": "idealista:pt:35410511",
                "isPrivateOwner": false,
                "location": {
                    "address": "Apartamento T2 na Rua Germão Galharde, 16, São Victor",
                    "council": null,
                    "district": null,
                    "latitude": null,
                    "longitude": null,
                    "neighborhood": null,
                    "parish": null
                },
                "postedAt": null,
                "price": {
                    "amount": 270000,
                    "currency": "EUR"
                },
                "pricePerSquareMeter": {
                    "amount": 3292.68,
                    "currency": "EUR"
                },
                "propertyType": "apartment",
                "source": "idealista",
                "title": "Apartamento T2 na Rua Germão Galharde, 16, São Victor",
                "transaction": "sale",
                "url": "https://www.idealista.pt/imovel/35410511/"
            }
        ],
        "pagination": {
            "currentPage": 1,
            "itemsPerPage": 30,
            "totalItems": 1249,
            "totalPages": 42
        }
    },
    "error": null,
    "message": "Idealista data retrieved."
}
Idealista Busca — TRECHOS DE CÓDIGO

curl --location --request GET 'https://zylalabs.com/api/14784/iberian+real+estate+api/38319/idealista+search?country=pt&location=braga&type=sale&propertyType=apartment&page=1' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Requisição
Retorna o número total de resultados do Idealista para uma pesquisa sem buscar as listagens em si
Endpoint ID: 38320
GET https://zylalabs.com/api/14784/iberian+real+estate+api/38320/idealista+result+totals
PARÂMETROS DE ENTRADA

Total de Resultados Idealista — Recursos do endpoint

Objeto Descrição
country Opcional Country code: pt, es, it or fr. Default is pt.
location Opcional Known city or area name such as braga, lisboa or madrid.
type Opcional Transaction type: sale or rent. Default is sale.
propertyType Opcional Property type: apartment or house. Default is apartment.

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

country
location
type
propertyType
RESPOSTA DE EXEMPLO DA API
JSON
{
    "data": {
        "searchTotalResults": 1249,
        "searchTotalResultsNoTypologyPhrase": "Ver 1.249 resultados",
        "searchTotalResultsPhrase": "Ver 1.249 anúncios",
        "searchTotalResultsWithTypologyPhrase": "Ver 1.249 casas"
    },
    "error": null,
    "message": "Idealista data retrieved."
}
Total de Resultados Idealista — TRECHOS DE CÓDIGO

curl --location --request GET 'https://zylalabs.com/api/14784/iberian+real+estate+api/38320/idealista+result+totals?country=pt&location=braga&type=sale&propertyType=apartment' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Requisição
Retorna sugestões de nomes de localização do Idealista com caminhos de localização canônicos e contagens de resultados para uma consulta de texto
Endpoint ID: 38321
GET https://zylalabs.com/api/14784/iberian+real+estate+api/38321/idealista+location+suggestions
PARÂMETROS DE ENTRADA

Sugestões de Localização Idealista — Recursos do endpoint

Objeto Descrição
searchField Obrigatório Text to search for, such as a city or neighborhood name.
country Opcional Country code: pt, es, it or fr. Default is pt.

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

searchField
country
RESPOSTA DE EXEMPLO DA API
JSON
{
    "data": [
        {
            "category": "Zona",
            "categoryAlias": null,
            "categoryId": null,
            "count": "993",
            "hasChildZones": true,
            "locationId": "0-EU-PT-03-03-001",
            "parentLocationId": "0-EU-PT-03-03",
            "seekablePostalCode": null,
            "suggestedLocationId": 38575,
            "text": "<b>Braga</b>, <b>Braga</b>",
            "totalResults": 3681,
            "url": "/comprar-casas/braga/braga/braga/",
            "vacational": false,
            "zoneOfInterest": false,
            "zoneOfInterestAlias": null
        }
    ],
    "error": null,
    "message": "Idealista data retrieved."
}
Sugestões de Localização Idealista — TRECHOS DE CÓDIGO

curl --location --request GET 'https://zylalabs.com/api/14784/iberian+real+estate+api/38321/idealista+location+suggestions?searchField=braga&country=pt' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Requisição
Detalhe normalizado para uma propriedade Idealista por código de país e ID numérico da propriedade
Endpoint ID: 38322
GET https://zylalabs.com/api/14784/iberian+real+estate+api/38322/idealista+listing+detail
PARÂMETROS DE ENTRADA

Solicitações gratuitas de teste restantes: 3 de 3.

RESPOSTA DE EXEMPLO DA API
JSON
{
    "data": {
        "address": null,
        "advertiser": {
            "name": "Tânia Cruz - RE/MAX",
            "url": null
        },
        "agency": {
            "name": "Tânia Cruz - RE/MAX",
            "type": "agency"
        },
        "amenities": [
            "Varanda"
        ],
        "areaSquareMeters": 82,
        "bathrooms": 1,
        "bedrooms": 2,
        "condition": "Segunda mão/bom estado",
        "constructionYear": 1996,
        "coordinates": null,
        "description": "Apartamento T2 com garagem e elevador, localizado na Rua Germão Galharde, em Braga.",
        "energy": {
            "consumption": null,
            "emissions": null,
            "emissionsRating": null,
            "rating": "C"
        },
        "featureLabels": [],
        "floor": "5º andar",
        "hasElevator": true,
        "hasVirtualTour": null,
        "id": "idealista:pt:35410511",
        "images": [
            "https://img4.idealista.pt/blur/WEB_DETAIL-M-L/0/id.pro.pt.image.master/3f/19/e4/331837072.jpg"
        ],
        "isFurnished": null,
        "isNewConstruction": null,
        "isPrivateOwner": false,
        "isTemporaryRental": null,
        "location": {
            "address": "São Victor, Braga",
            "council": null,
            "district": null,
            "latitude": null,
            "longitude": null,
            "neighborhood": null,
            "parish": null
        },
        "media": [
            {
                "type": "image",
                "url": "https://img4.idealista.pt/blur/WEB_DETAIL-M-L/0/id.pro.pt.image.master/3f/19/e4/331837072.jpg"
            }
        ],
        "orientation": null,
        "plotAreaSquareMeters": null,
        "postedAt": null,
        "price": {
            "amount": 270000,
            "currency": "EUR"
        },
        "pricePerSquareMeter": {
            "amount": 3292.68,
            "currency": "EUR"
        },
        "priceReduction": null,
        "propertyAge": null,
        "propertySubtype": null,
        "propertyType": "apartment",
        "reference": null,
        "source": "idealista",
        "title": "Apartamento T2 à venda na Rua Germão Galharde, 16",
        "totalFloors": null,
        "transaction": "sale",
        "updatedAt": null,
        "url": "https://www.idealista.pt/imovel/35410511/",
        "usableAreaSquareMeters": null
    },
    "error": null,
    "message": "Listing found."
}
Detalhe do Anúncio Idealista — TRECHOS DE CÓDIGO

curl --location --request GET 'https://zylalabs.com/api/14784/iberian+real+estate+api/38322/idealista+listing+detail&country=Required&/=Required&id=Required' --header 'Authorization: Bearer YOUR_API_KEY' 


    

Chave de acesso à API e autenticação

Após se cadastrar, cada desenvolvedor recebe uma chave de acesso à API pessoal, uma combinação única de letras e dígitos para acessar nosso endpoint de API. Para autenticar com a Imóveis Ibéricos API basta incluir seu token Bearer no cabeçalho Authorization.

Cabeçalhos
Cabeçalho Descrição
Authorization Obrigatório Deve ser Bearer access_key. Veja "Sua chave de acesso à API" acima quando você estiver inscrito.

Sem compromisso de longo prazo. Faça upgrade, downgrade ou cancele a qualquer momento.

A partir de
$10.000/Ano


  • Volume personalizado
  • Limite de taxa personalizado
  • Suporte ao cliente especializado
  • Monitoramento de API em tempo real

Visão Geral

Listagens de propriedades ao vivo para Portugal, Espanha, Itália e França da Idealista, Imovirtual, Fotocasa e Casa Sapo em uma API JSON, com detalhes dos anúncios, estatísticas de preço por m2, rendimento de aluguel, avaliação e um localizador de negócios

Imóveis Ibéricos API FAQs

Portugal (Imovirtual Casa Sapo Idealista) Espanha (Fotocasa Idealista) Itália (Idealista) e França (Idealista)

Cada resposta tem erro dados e mensagem Verifique o erro primeiro os dados são nulos em qualquer erro

A solicitação ainda é bem-sucedida com os outros portais Sempre verifique a matriz de fontes na resposta para um erro não nulo em qualquer fonte

Use o id exatamente como retornado pela busca, por exemplo imovirtual:some-slug. Nunca construa um id a partir de uma URL de portal ou número de anúncio

Ele precifica sua propriedade com base no preço médio por m2 de listagens comparáveis atualmente no mercado Confira a confiança e o tamanho da amostra Não é uma avaliação profissional

Não Todas as figuras são provenientes dos preços pedidos atuais em listagens ao vivo não dos preços de venda ou aluguel realizados

Entre em contato com o suporte no Telegram @pintoflow para dúvidas novos campos ou limites maiores

Perguntas Frequentes Gerais

O Zyla API Hub é como uma grande loja de APIs, onde você pode encontrar milhares delas em um só lugar. Também oferecemos suporte dedicado e monitoramento em tempo real de todas as APIs. Após se cadastrar, você pode escolher quais APIs deseja usar. Lembre-se apenas de que cada API precisa de sua própria assinatura. Mas se você se inscrever em várias, usará a mesma chave para todas elas, facilitando as coisas para você.
Os preços são listados em USD (Dólar Americano), EUR (Euro), CAD (Dólar Canadense), AUD (Dólar Australiano) e GBP (Libra Esterlina). Aceitamos todos os principais cartões de débito e crédito. Nosso sistema de pagamento usa a mais recente tecnologia de segurança e é operado pela Stripe, uma das empresas de pagamento mais confiáveis do mundo. Se tiver problemas para pagar com cartão, entre em contato conosco em [email protected]

Além disso, se você já tiver uma assinatura ativa em qualquer uma dessas moedas (USD, EUR, CAD, AUD, GBP), essa moeda será mantida para assinaturas subsequentes. Você pode alterar a moeda a qualquer momento, desde que não tenha assinaturas ativas.
A moeda local exibida na página de preços é baseada no país do seu endereço IP e é fornecida apenas como referência. Os preços reais são em USD (Dólar Americano). Ao efetuar o pagamento, a cobrança aparecerá no extrato do seu cartão em USD, mesmo que você veja o valor equivalente em sua moeda local em nosso site. Isso significa que você não pode pagar diretamente com sua moeda local.
Ocasionalmente, o banco pode recusar a cobrança devido às configurações de proteção contra fraude. Sugerimos contatar seu banco inicialmente para verificar se estão bloqueando nossas cobranças. Você também pode acessar o Portal de Cobrança e alterar o cartão associado para realizar o pagamento. Se isso não funcionar e precisar de mais ajuda, entre em contato com nossa equipe em [email protected]
Os preços são determinados por uma assinatura recorrente mensal ou anual, dependendo do plano escolhido.
As chamadas de API são descontadas do seu plano com base nas requisições bem-sucedidas. Cada plano possui um número específico de chamadas por mês. Apenas chamadas bem-sucedidas, indicadas por uma resposta com Status 200, serão contabilizadas, garantindo que falhas não afetem sua cota mensal.
O Zyla API Hub funciona com um sistema de assinatura mensal recorrente. Seu ciclo de cobrança começa no dia em que você compra um dos planos pagos e será renovado no mesmo dia do mês seguinte. Portanto, cancele sua assinatura com antecedência se quiser evitar cobranças futuras.
Para fazer upgrade do seu plano atual, acesse a página de preços da API e selecione o novo plano desejado. O upgrade é instantâneo, permitindo aproveitar imediatamente os recursos do novo plano. Observe que as chamadas restantes do plano anterior não serão transferidas; você será cobrado pelo valor integral do novo plano.
Para verificar quantas chamadas de API restam para o mês atual, consulte o campo 'X-Zyla-API-Calls-Monthly-Remaining' no cabeçalho da resposta. Por exemplo, se seu plano permite 1.000 requisições por mês e você usou 100, este campo no cabeçalho da resposta indicará 900 chamadas restantes.
Para ver o número máximo de requisições de API que seu plano permite, verifique o cabeçalho de resposta 'X-Zyla-RateLimit-Limit'. Por exemplo, se seu plano inclui 1.000 requisições por mês, este cabeçalho exibirá 1.000.
O cabeçalho 'X-Zyla-RateLimit-Reset' mostra o número de segundos até seu limite de taxa ser redefinido. Isso informa quando sua contagem de requisições começará do zero. Por exemplo, se exibir 3.600, significa que restam 3.600 segundos até o limite ser redefinido.
Sim, você pode cancelar seu plano a qualquer momento acessando sua conta e selecionando a opção de cancelamento na página de Cobrança. Observe que upgrades, downgrades e cancelamentos têm efeito imediato. Além disso, após o cancelamento, você não terá mais acesso ao serviço, mesmo que ainda tenha chamadas restantes na sua cota.
Para oferecer a oportunidade de experimentar nossas APIs sem compromisso, oferecemos um teste gratuito de 7 dias que permite realizar até 50 chamadas de API sem custo. Esse teste pode ser usado apenas uma vez; recomendamos aplicá-lo à API que mais interessa. Embora a maioria das APIs ofereça teste gratuito, algumas podem não oferecer. O teste termina após 7 dias ou quando você atingir 50 requisições, o que ocorrer primeiro. Se atingir o limite, será necessário "Iniciar seu plano pago" para continuar. Você encontra esse botão no perfil em Assinatura -> Escolha a API -> aba Preços. Se não cancelar até o 7º dia, sua assinatura será cobrada automaticamente, liberando todas as chamadas do plano.
Após 7 dias, será cobrado o valor total do plano ao qual você estava inscrito durante o teste. Portanto, é importante cancelar antes do término do período. Solicitações de reembolso por esquecimento de cancelamento não são aceitas.
Ao assinar um teste gratuito de API, você pode fazer até 50 chamadas. Se desejar fazer chamadas adicionais além desse limite, a API solicitará que você "Inicie seu plano pago". Você encontra o botão no perfil em Assinatura -> Escolha a API -> aba Preços.
As Ordens de Pagamento são processadas entre os dias 20 e 30 de cada mês. Se você enviar sua solicitação antes do dia 20, seu pagamento será processado dentro desse período.
Você pode nos contatar via chat para receber assistência imediata. Estamos online de 8h às 17h (EST). Se nos contatar após esse horário, retornaremos o mais rápido possível. Além disso, você pode enviar um e-mail para [email protected]

APIs relacionadas