{
"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)."
}
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'
{
"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."
}
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'
{
"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."
}
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'
{
"data": {
"countries": {
"es": [
"fotocasa",
"idealista"
]
},
"maxBatchSize": 20,
"sections": [
"media",
"features",
"location",
"advertiser",
"pricing"
]
},
"error": null,
"message": "Listing source capabilities."
}
curl --location --request GET 'https://zylalabs.com/api/14784/iberian+real+estate+api/38309/listing+sources?country=es' --header 'Authorization: Bearer YOUR_API_KEY'
{
"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."
}
curl --location --request GET 'https://zylalabs.com/api/14784/iberian+real+estate+api/38310/listing+detail&id=Required' --header 'Authorization: Bearer YOUR_API_KEY'
{
"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."
}
curl --location --request GET 'https://zylalabs.com/api/14784/iberian+real+estate+api/38311/listing+media&id=Required' --header 'Authorization: Bearer YOUR_API_KEY'
{
"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."
}
curl --location --request GET 'https://zylalabs.com/api/14784/iberian+real+estate+api/38312/listing+features&id=Required' --header 'Authorization: Bearer YOUR_API_KEY'
{
"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."
}
curl --location --request GET 'https://zylalabs.com/api/14784/iberian+real+estate+api/38313/listing+location&id=Required' --header 'Authorization: Bearer YOUR_API_KEY'
{
"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."
}
curl --location --request GET 'https://zylalabs.com/api/14784/iberian+real+estate+api/38314/listing+advertiser&id=Required' --header 'Authorization: Bearer YOUR_API_KEY'
{
"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."
}
curl --location --request GET 'https://zylalabs.com/api/14784/iberian+real+estate+api/38315/listing+pricing&id=Required' --header 'Authorization: Bearer YOUR_API_KEY'
{
"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\"."
}
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'
{
"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))."
}
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'
{
"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)."
}
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'
{
"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."
}
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'
{
"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."
}
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'
{
"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."
}
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'
{
"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."
}
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'
注册后,每个开发者都会被分配一个个人 API 访问密钥,这是一个唯一的字母和数字组合,用于访问我们的 API 端点。要使用 伊比利亚房地产 API 进行身份验证,只需在 Authorization 标头中包含您的 bearer token。
| 标头 | 描述 |
|---|---|
授权
|
必需
应为 Bearer access_key. 订阅后,请查看上方的"您的 API 访问密钥"。
|
来自Idealista Imovirtual Fotocasa和Casa Sapo的葡萄牙 西班牙 意大利和法国的实时房产列表 在一个JSON API中 包括列表详情 每平方米价格统计 租金收益 估值和交易查找器
葡萄牙(Imovirtual Casa Sapo Idealista) 西班牙(Fotocasa Idealista) 意大利(Idealista)和法国(Idealista) 使用国家参数:pt es it 或 fr
每个响应都有错误 数据和消息 首先检查错误 数据在任何错误时为null
请求在其他门户上仍然成功。始终检查响应中的源数组以查看任何源是否存在非空错误
使用搜索返回的id,例如imovirtual:some-slug。不要从门户网站的URL或广告编号构建id
它根据当前市场上可比房源的中位价格每平方米为您的物业定价 检查信心和样本大小 这不是专业评估
不 所有数字来自于当前在售列表上的要价 而不是成交价格或租赁价格
在Telegram上联系支持 @pintoflow 以获取问题 新字段或更高的限制