伊比利亚房地产 API

API ID 14784

葡萄牙 西班牙 意大利 和 法国 的实时房产列表 来自 Idealista Imovirtual Fotocasa 和 Casa Sapo 的一个 JSON API 包含上市详情 每平方米价格统计 租金收益 估值 和 搜索交易工具

API 文档

端点

请求
同时搜索一个国家的每个门户并返回一个合并的列表,包括价格、面积、卧室、位置和代理。查看来源数组以获取每个来源的错误
Endpoint ID: 38306
GET https://zylalabs.com/api/14784/iberian+real+estate+api/38306/search+listings
输入参数

搜索列表 — 端点功能

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

剩余免费测试请求:3 / 3。


输入参数

location
type
propertyType
minPrice
maxPrice
bedrooms
country
source
page
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)."
}
搜索列表 — 代码片段

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' 


    
请求
与搜索列表相同的筛选器,但返回当前搜索页面的平均值、中位数、最小值和最大值以及每平方米价格
Endpoint ID: 38307
GET https://zylalabs.com/api/14784/iberian+real+estate+api/38307/search+summary
输入参数

搜索摘要 — 端点功能

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

剩余免费测试请求:3 / 3。


输入参数

location
type
propertyType
minPrice
maxPrice
bedrooms
country
source
page
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."
}
搜索摘要 — 代码片段

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' 


    
请求
与搜索列表相同的过滤器,但返回当前页面按来源、物业类型、交易和卧室的观察值计数
Endpoint ID: 38308
GET https://zylalabs.com/api/14784/iberian+real+estate+api/38308/search+facets
输入参数

搜索面貌 — 端点功能

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

剩余免费测试请求:3 / 3。


输入参数

location
type
propertyType
minPrice
maxPrice
bedrooms
country
source
page
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."
}
搜索面貌 — 代码片段

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' 


    
请求
列出了每个国家可用的来源 存在的详细部分和最大批量大小
Endpoint ID: 38309
GET https://zylalabs.com/api/14784/iberian+real+estate+api/38309/listing+sources
输入参数

列出来源 — 端点功能

对象 描述
country 可选 Country code: pt, es, it or fr. Default is pt.

剩余免费测试请求:3 / 3。


输入参数

country
API 示例响应
JSON
{
    "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' 


    
请求
根据搜索返回的 ID 获取一个列表的所有详细信息:描述 图片 特征 能源评级 广告商 坐标等
Endpoint ID: 38310
GET https://zylalabs.com/api/14784/iberian+real+estate+api/38310/listing+detail
输入参数

剩余免费测试请求:3 / 3。

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."
}
列表详情 — 代码片段

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


    
请求
通过搜索返回的id获取一个列表的图像、输入的媒体项和虚拟 tour 可用性
Endpoint ID: 38311
GET https://zylalabs.com/api/14784/iberian+real+estate+api/38311/listing+media
输入参数

剩余免费测试请求:3 / 3。

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."
}
上市媒体 — 代码片段

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


    
请求
物业特点 设施 能源评级和来源特征 通过搜索返回的ID获取一个房源的信息
Endpoint ID: 38312
GET https://zylalabs.com/api/14784/iberian+real+estate+api/38312/listing+features
输入参数

剩余免费测试请求:3 / 3。

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."
}
列出特征 — 代码片段

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


    
请求
位置名称 街道地址 和坐标 通过搜索返回的 id 获取一个列表
Endpoint ID: 38313
GET https://zylalabs.com/api/14784/iberian+real+estate+api/38313/listing+location
输入参数

剩余免费测试请求:3 / 3。

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."
}
列出位置 — 代码片段

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


    
请求
通过搜索返回的ID获取一个列表的代理或广告商详细信息、私人业主标志和列表参考
Endpoint ID: 38314
GET https://zylalabs.com/api/14784/iberian+real+estate+api/38314/listing+advertiser
输入参数

剩余免费测试请求:3 / 3。

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."
}
上市广告商 — 代码片段

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


    
请求
价格 每平方米价格 价格降低 以及通过搜索返回的id的一个列表的发布日期和更新日期
Endpoint ID: 38315
GET https://zylalabs.com/api/14784/iberian+real+estate+api/38315/listing+pricing
输入参数

剩余免费测试请求:3 / 3。

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."
}
清单定价 — 代码片段

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


    
请求
当前每平方米购买和租赁的平均及中位数价格,同时根据挂牌价格实时计算的毛租金收益率估算
Endpoint ID: 38316
GET https://zylalabs.com/api/14784/iberian+real+estate+api/38316/area+market+stats
输入参数

区域市场统计 — 端点功能

对象 描述
propertyType 可选 Property type: apartment or house. Default is apartment.
country 可选 Country code: pt, es, it or fr. Default is pt.
source 可选 Optional comma separated sources such as imovirtual,casasapo.
area 必需

剩余免费测试请求:3 / 3。


输入参数

propertyType
country
source
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\"."
}
区域市场统计 — 代码片段

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' 


    
请求
估算同一区域内当前在售类似房产的价格,包括价格范围和可信度
Endpoint ID: 38317
GET https://zylalabs.com/api/14784/iberian+real+estate+api/38317/property+valuation
输入参数

房地产评估 — 端点功能

对象 描述
area 必需 Known city or area name such as lisboa or madrid.
areaSquareMeters 必需 Floor area of the property in square meters.
bedrooms 可选 Number of bedrooms. Optional, narrows the comparable set.
propertyType 可选 Property type: apartment or house. Default is apartment.
transaction 可选 Transaction type: sale or rent. Default is sale.
country 可选 Country code: pt, es, it or fr. Default is pt.
source 可选 Optional comma separated sources such as imovirtual,casasapo.

剩余免费测试请求:3 / 3。


输入参数

area
areaSquareMeters
bedrooms
propertyType
transaction
country
source
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))."
}
房地产评估 — 代码片段

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' 


    
请求
按每平方米低于该地区中位数价格的程度对该地区当前的挂牌进行排名,最佳得分优先
Endpoint ID: 38318
GET https://zylalabs.com/api/14784/iberian+real+estate+api/38318/deal+finder
输入参数

优惠查找器 — 端点功能

对象 描述
propertyType 可选 Property type: apartment or house. Default is apartment.
transaction 可选 Transaction type: sale or rent. Default is sale.
country 可选 Country code: pt, es, it or fr. Default is pt.
source 可选 Optional comma separated sources such as imovirtual,casasapo.
limit 可选 How many deals to return, from 1 to 50. Default is 10.
area 必需

剩余免费测试请求:3 / 3。


输入参数

propertyType
transaction
country
source
limit
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)."
}
优惠查找器 — 代码片段

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' 


    
请求
直接搜索Idealista并返回带有分页的规范化列表,适用于葡萄牙、西班牙、意大利或法国
Endpoint ID: 38319
GET https://zylalabs.com/api/14784/iberian+real+estate+api/38319/idealista+search
输入参数

理想家搜索 — 端点功能

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

剩余免费测试请求:3 / 3。


输入参数

country
location
type
propertyType
minPrice
maxPrice
bedrooms
page
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."
}
理想家搜索 — 代码片段

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' 


    
请求
返回搜索的Idealista结果的总数,不获取列表本身
Endpoint ID: 38320
GET https://zylalabs.com/api/14784/iberian+real+estate+api/38320/idealista+result+totals
输入参数

理想主义者结果总计 — 端点功能

对象 描述
country 可选 Country code: pt, es, it or fr. Default is pt.
location 可选 Known city or area name such as braga, lisboa or madrid.
type 可选 Transaction type: sale or rent. Default is sale.
propertyType 可选 Property type: apartment or house. Default is apartment.

剩余免费测试请求:3 / 3。


输入参数

country
location
type
propertyType
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."
}
理想主义者结果总计 — 代码片段

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' 


    
请求
返回理想地点名称建议,包括规范位置路径和文本查询的结果数量
Endpoint ID: 38321
GET https://zylalabs.com/api/14784/iberian+real+estate+api/38321/idealista+location+suggestions
输入参数

理想者地点建议 — 端点功能

对象 描述
searchField 必需 Text to search for, such as a city or neighborhood name.
country 可选 Country code: pt, es, it or fr. Default is pt.

剩余免费测试请求:3 / 3。


输入参数

searchField
country
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."
}
理想者地点建议 — 代码片段

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' 


    
请求
按国家代码和数值物业 ID 正规化的 Idealista 物业详细信息
Endpoint ID: 38322
GET https://zylalabs.com/api/14784/iberian+real+estate+api/38322/idealista+listing+detail
输入参数

剩余免费测试请求:3 / 3。

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."
}
理想主义者列表详情 — 代码片段

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 端点。要使用 伊比利亚房地产 API 进行身份验证,只需在 Authorization 标头中包含您的 bearer token。

标头
标头 描述
授权 必需 应为 Bearer access_key. 订阅后,请查看上方的"您的 API 访问密钥"。

无长期承诺。随时升级、降级或取消。

起价
$10,000/年


  • 自定义数量
  • 自定义速率限制
  • 专业客户支持
  • 实时 API 监控

概览

来自Idealista Imovirtual Fotocasa和Casa Sapo的葡萄牙 西班牙 意大利和法国的实时房产列表 在一个JSON API中 包括列表详情 每平方米价格统计 租金收益 估值和交易查找器

伊比利亚房地产 API FAQs

葡萄牙(Imovirtual Casa Sapo Idealista) 西班牙(Fotocasa Idealista) 意大利(Idealista)和法国(Idealista) 使用国家参数:pt es it 或 fr

每个响应都有错误 数据和消息 首先检查错误 数据在任何错误时为null

请求在其他门户上仍然成功。始终检查响应中的源数组以查看任何源是否存在非空错误

使用搜索返回的id,例如imovirtual:some-slug。不要从门户网站的URL或广告编号构建id

它根据当前市场上可比房源的中位价格每平方米为您的物业定价 检查信心和样本大小 这不是专业评估

不 所有数字来自于当前在售列表上的要价 而不是成交价格或租赁价格

在Telegram上联系支持 @pintoflow 以获取问题 新字段或更高的限制

一般常见问题

Zyla API Hub 就像一个大型 API 商店,您可以在一个地方找到数千个 API。我们还为所有 API 提供专门支持和实时监控。注册后,您可以选择要使用的 API。请记住,每个 API 都需要自己的订阅。但如果您订阅多个 API,您将为所有这些 API 使用相同的密钥,使事情变得更简单。
价格以 USD(美元)、EUR(欧元)、CAD(加元)、AUD(澳元)和 GBP(英镑)列出。我们接受所有主要的借记卡和信用卡。我们的支付系统使用最新的安全技术,由 Stripe 提供支持,Stripe 是世界上最可靠的支付公司之一。如果您在使用卡片付款时遇到任何问题,请通过 [email protected]

此外,如果您已经以这些货币中的任何一种(USD、EUR、CAD、AUD、GBP)拥有有效订阅,该货币将保留用于后续订阅。只要您没有任何有效订阅,您可以随时更改货币。
定价页面上显示的本地货币基于您 IP 地址的国家/地区,仅供参考。实际价格以 USD(美元)为单位。当您付款时,即使您在我们的网站上看到以本地货币显示的等值金额,您的卡片对账单上也会以美元显示费用。这意味着您不能直接使用本地货币付款。
有时,银行可能会因其欺诈保护设置而拒绝收费。我们建议您首先联系您的银行,检查他们是否阻止了我们的收费。此外,您可以访问账单门户并更改关联的卡片以进行付款。如果这些方法不起作用并且您需要进一步帮助,请通过 [email protected]
价格由月度或年度订阅决定,具体取决于所选计划。
API 调用根据成功请求从您的计划中扣除。每个计划都包含您每月可以进行的特定数量的调用。只有成功的调用(由状态 200 响应指示)才会计入您的总数。这确保失败或不完整的请求不会影响您的月度配额。
Zyla API Hub 采用月度订阅系统。您的计费周期将从您购买付费计划的那一天开始,并在下个月的同一日期续订。因此,如果您想避免未来的费用,请提前取消订阅。
要升级您当前的订阅计划,只需转到 API 的定价页面并选择您要升级到的计划。升级将立即生效,让您立即享受新计划的功能。请注意,您之前计划中的任何剩余调用都不会转移到新计划,因此在升级时请注意这一点。您将被收取新计划的全部金额。
要检查您本月剩余多少 API 调用,请参考响应标头中的 "X-Zyla-API-Calls-Monthly-Remaining" 字段。例如,如果您的计划允许每月 1,000 个请求,而您已使用 100 个,则响应标头中的此字段将显示 900 个剩余调用。
要查看您的计划允许的最大 API 请求数,请检查 "X-Zyla-RateLimit-Limit" 响应标头。例如,如果您的计划包括每月 1,000 个请求,此标头将显示 1,000。
"X-Zyla-RateLimit-Reset" 标头显示您的速率限制重置之前的秒数。这告诉您何时您的请求计数将重新开始。例如,如果它显示 3,600,则意味着还有 3,600 秒直到限制重置。
是的,您可以随时通过访问您的账户并在账单页面上选择取消选项来取消您的计划。请注意,升级、降级和取消会立即生效。此外,取消后,您将不再有权访问该服务,即使您的配额中还有剩余调用。
为了让您有机会在没有任何承诺的情况下体验我们的 API,我们提供 7 天免费试用,允许您免费进行最多 50 次 API 调用。此试用只能使用一次,因此我们建议将其应用于您最感兴趣的 API。虽然我们的大多数 API 都提供免费试用,但有些可能不提供。试用在 7 天后或您进行了 50 次请求后结束,以先发生者为准。如果您在试用期间达到 50 次请求限制,您需要"开始您的付费计划"以继续发出请求。您可以在个人资料中的订阅 -> 选择您订阅的 API -> 定价标签下找到"开始您的付费计划"按钮。或者,如果您在第 7 天之前不取消订阅,您的免费试用将结束,您的计划将自动计费,授予您访问计划中指定的所有 API 调用的权限。请记住这一点以避免不必要的费用。
7 天后,您将被收取试用期间订阅的计划的全额费用。因此,在试用期结束前取消很重要。因忘记及时取消而提出的退款请求不被接受。
当您订阅 API 免费试用时,您可以进行最多 50 次 API 调用。如果您希望超出此限制进行额外的 API 调用,API 将提示您执行"开始您的付费计划"。您可以在个人资料中的订阅 -> 选择您订阅的 API -> 定价标签下找到"开始您的付费计划"按钮。
付款订单在每月 20 日至 30 日之间处理。如果您在 20 日之前提交请求,您的付款将在此时间范围内处理。
您可以通过我们的聊天渠道联系我们以获得即时帮助。我们始终在线,时间为上午 8 点至下午 5 点(EST)。如果您在该时间之后联系我们,我们将尽快回复您。此外,您可以通过 [email protected]

相关 API