理想主义者 API

API ID 15077

西班牙语 意大利语 葡萄牙语和法语房地产:带有过滤器的房产买卖或租赁搜索 房产详情 照片 类似房屋 代理和位置查询

100% 正常运行时间 981 ms 平均响应

API 文档

端点

请求
返回房地产中介的资料:名称、开始运营年份、地址及坐标、标志、图片、所讲语言、上市房产数量及主要经营和房产类型
Endpoint ID: 40027
GET https://zylalabs.com/api/15077/idealista+api/40027/agency+details
输入参数

代理机构详情 — 端点功能

对象 描述
country 必需 Country code: "es" (Spain), "it" (Italy), "pt" (Portugal) or "fr" (France). Use the /general/countries endpoint to list valid values.
agency_id 必需 Agency id (e.g. "walterhauschamberi"). It is the "advertiser.agency_id" of a property returned by the /property/search endpoint.

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


输入参数

country
agency_id
API 示例响应
JSON
{
    "agency_id": "walterhauschamberi",
    "country": "es",
    "name": "Walter Haus Madrid",
    "website": "http://walterhaus.es/es",
    "active_since": 2021,
    "phone": "+34919386183",
    "address": {
        "street": "Paseo General Martinez Campos",
        "number": "13",
        "postal_code": "28010",
        "city": "Madrid"
    },
    "latitude": 40.4352603,
    "longitude": -3.6966394,
    "logo": "https://st3.idealista.com/ff/20/20/walterhauschamberi.gif",
    "image": "https://st3.idealista.com/b5/c2/23/main-walterhauschamberi.jpg",
    "languages": [
        "es",
        "ca",
        "en",
        "fr",
        "de",
        "nl",
        "ru",
        "zh"
    ],
    "total_properties": 99,
    "main_operation": "sale",
    "main_property_type": "homes"
}
代理机构详情 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/15077/idealista+api/40027/agency+details?country=es&agency_id=walterhauschamberi' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
列出代理机构待售或出租的房产:房产编号、链接、标题、房产类型、价格、每平方米价格、降价、面积、房间、浴室、楼层、描述、标签、地址、坐标、特点、停车位、带房间标签的照片、视频、虚拟导览和广告商。返回房产的总数和页数。接受与/property/search端点相同的过滤条件,位置为选填。价格以欧元计算,面积以平方米计算
Endpoint ID: 40028
GET https://zylalabs.com/api/15077/idealista+api/40028/agency+properties
输入参数

代理属性 — 端点功能

对象 描述
country 必需 Country code: "es" (Spain), "it" (Italy), "pt" (Portugal) or "fr" (France). Use the /general/countries endpoint to list valid values.
agency_id 必需 Agency id (e.g. "walterhauschamberi"). It is the "advertiser.agency_id" of a property returned by the /property/search endpoint.
operation 必需 Operation: "sale" or "rent".
property_type 可选 Optional property type (defaults to "homes"). Use the /general/property-types endpoint to list valid values and the operations each one is available with.
location_id 可选 Optional location id to narrow the properties to (e.g. "0-EU-ES-28"). Use the /location/search or /location/list endpoint to find it.
min_price 可选 Optional minimum price in euros (monthly rent for operation "rent").
max_price 可选 Optional maximum price in euros (monthly rent for operation "rent").
min_size 可选 Optional minimum size in square meters.
max_size 可选 Optional maximum size in square meters.
bedrooms 可选 Optional number of bedrooms, one or more values separated by commas: "0" (studio), "1", "2", "3" or "4" (4 or more). E.g. "2,3".
bathrooms 可选 Optional number of bathrooms, one or more values separated by commas: "1", "2" or "3" (3 or more).
sort 可选 Optional sort order (defaults to "relevance"). Use the /general/sort-orders endpoint to list valid values.
page 可选 Optional page number, 50 properties per page, up to 50 pages (defaults to 1).
language 可选 Optional language of the texts (defaults to "en"): "en", "es", "it", "pt", "fr", "de", "ca", "nl", "pl", "ro", "ru", "sv", "da", "fi", "nb", "el", "uk" or "zh".

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


输入参数

country
agency_id
operation
property_type
location_id
min_price
max_price
min_size
max_size
bedrooms
bathrooms
sort
page
language
API 示例响应
JSON
{
    "country": "es",
    "operation": "sale",
    "property_type": "homes",
    "agency_id": "walterhauschamberi",
    "title": null,
    "total": 88,
    "page": 1,
    "page_size": 50,
    "total_pages": 2,
    "properties": [
        {
            "id": "106387165",
            "url": "https://www.idealista.com/inmueble/106387165/",
            "title": "Penthouse in Goya, Madrid",
            "property_type": "flat",
            "property_subtype": "penthouse",
            "operation": "sale",
            "price": 3390000,
            "currency": "EUR",
            "price_period": null,
            "price_per_m2": 12890,
            "price_drop": null,
            "size_m2": 263,
            "rooms": 4,
            "bathrooms": 5,
            "guests": null,
            "floor": "5",
            "exterior": true,
            "has_lift": true,
            "status": "good",
            "new_development": false,
            "development_name": null,
            "description": "We present to you EXCLUSIVELY a unique property on the top floor of a royal estate with an exceptional location. La Casa de las Bolas, also known as the Casa de los Picos, is a unique building located in the Salamanca neighborhood, in Madrid. Its name comes from the peculiar façade adorned with protruding stone bollards or “balls”, a feature that gives it a distinctive and striking appearance compared to the architectural style of the surrounding buildings. This peculiar design responds to a mix of historical and artistic influences, which have given rise to a unique structure of its kind and an object of curiosity for those who visit the area.  Built at the beginning of the 20th century, the Casa de las Bolas was designed by architect Julio Martínez Zapata, known for his modernist approach and his ability to integrate innovative and decorative elements in his works. The building has several floors, and its façade is decorated with a series of stone balls that run throughout its exterior in an orderly manner, generating an impressive visual effect.   In addition to its unique façade, the Casa de las Bolas has a structure and interior layout typical of buildings from the early 20th century in Madrid, with high ceilings, large windows and a spacious layout. However, the particularity of its external design makes it a point of interest for photographers, architects and tourists looking for historical and curious buildings in the Spanish capital.  Today, the Casa de las Bolas is a symbol of the Salamanca neighborhood and a leading example of the unique architecture that can be found in Madrid, reminding us of the rich architectural history and creativity of urban designs that have shaped this city.  Currently being renovated, this spacious home has six bedrooms and four bathrooms.   This unique and unique home has 14 balconies facing the street, in addition to its magnificent south-east, west orientation, it offers you, as it is a corner and with height, an unmatched luminosity, from where you can see the skyline of Madrid from an unbeatable situation. A few meters from Retiro Park, the green lung of the city.   Don't miss this investment opportunity in one of the most sought-after areas. Contact us for more information and to schedule a visit!  Walter Haus Real Estate is a real estate group based in the main capitals of Spain, in the main locations of Madrid, Barcelona and Costa Brava.  We have more than 20 years of experience, with a dynamic team of professionals with experience in personal advice in constant training and with a very specific specialization in each area of action, which allows us to find solutions to the needs of each client.   Walter Haus Real Estate is a real estate group based in the main capitals of Spain, in the main locations of Madrid, Barcelona and Costa Brava.  We have more than 20 years of experience, with a dynamic team of professionals with experience in personal advice in constant training and with a very specific specialization in each area of action, which allows us to find solutions to the needs of each client.",
            "labels": [
                "Luxury"
            ],
            "address": "Penthouse in Goya, Madrid",
            "province": "Madrid",
            "municipality": "Madrid",
            "district": "Barrio de Salamanca",
            "neighborhood": "Goya",
            "location_id": "0-EU-ES-28-07-001-079-04-002",
            "latitude": 40.4233982,
            "longitude": -3.6760023,
            "exact_location": false,
            "features": {
                "swimming_pool": false,
                "terrace": true,
                "air_conditioning": true,
                "garden": false,
                "storage_room": false
            },
            "parking": null,
            "reviews": null,
            "thumbnail": "https://img4.idealista.com/s/v1/yLueJcFaPGYMndqtd3fIzo9BdwYl4inLwTKbMiVSdz4l4khBqGDIaJvI4s5m5JvBd6j3d3o-dz61dwYIenr3Pj4LegjI9Zuoyw?Expires=1795173155&Signature=MEUCIB-~oJM5IAXsH62zqBbKqwtYCKRbJeVZyrA1qlkK-kS-AiEA6zjAQu24AsKyPkMujBDuqgDCqsMotwizMSWsuMClIdI_&Key-Pair-Id=K20EOYVFELHOX5",
            "photo_count": 72,
            "has_video": true,
            "has_plan": true,
            "has_3d_tour": true,
            "has_360": false,
            "images": [
                {
                    "url": "https://img4.idealista.com/s/v1/yLueJcFaPGYMndqtd3fIzo9BdwYl4inLwTKbMiVSdz4l4khBqGDIaJvI4s5m5JvBd6j3d3o-dz61dwYIenr3Pj4LegjI9Zuoyw?Expires=1795173155&Signature=MEYCIQD8jT71GCrvVJw6XrDWzWhkcZhFzSF0StN9V~duKHp3fAIhALXEKH5b1~iHvPJ0wRY71rLHceJMtVdwTfQHFKpXyP67&Key-Pair-Id=K20EOYVFELHOX5",
                    "tag": "livingRoom"
                }
            ],
            "videos": [
                {
                    "url": "https://st3v.idealista.com/5d/01/53/1382161016.mp4",
                    "thumbnail": "https://st3v.idealista.com/5d/01/53/1382161016.jpg"
                }
            ],
            "virtual_tours": [
                {
                    "url": "https://my.matterport.com/show/?m=7QZpQ36rzZU&lang=en",
                    "type": "3d",
                    "thumbnail": "https://img4.idealista.com/s/v1/yLueJcFaPGYMndqtd3fIzo9BdwYl4inLwTKbMiVSdz4l4khBqGDIaJvI4s5m5JvBd6j3d3o-dz61dwYIenr3Pj4LegjI9Zuoyw?Expires=1795173155&Signature=MEYCIQD8jT71GCrvVJw6XrDWzWhkcZhFzSF0StN9V~duKHp3fAIhALXEKH5b1~iHvPJ0wRY71rLHceJMtVdwTfQHFKpXyP67&Key-Pair-Id=K20EOYVFELHOX5"
                }
            ],
            "advertiser": {
                "type": "professional",
                "name": "Walter Haus",
                "commercial_name": "Walter Haus Madrid",
                "reference": "M11468V",
                "phone": "+34919385698",
                "logo": "https://st3.idealista.com/ff/20/20/walterhauschamberi.gif",
                "agency_id": "walterhauschamberi",
                "address": null
            },
            "published_at": null
        }
    ]
}
代理属性 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/15077/idealista+api/40028/agency+properties?country=es&agency_id=walterhauschamberi&operation=sale&property_type=homes&sort=relevance&page=1&language=en' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
列出"国家"参数接受的代码所涵盖的国家及其名称
Endpoint ID: 40029
GET https://zylalabs.com/api/15077/idealista+api/40029/countries
输入参数

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

此端点不需要任何输入参数。

API 示例响应
JSON
[
    {
        "code": "es",
        "name": "Spain",
        "website": "https://www.idealista.com"
    },
    {
        "code": "it",
        "name": "Italy",
        "website": "https://www.idealista.it"
    },
    {
        "code": "pt",
        "name": "Portugal",
        "website": "https://www.idealista.pt"
    },
    {
        "code": "fr",
        "name": "France",
        "website": "https://www.idealista.fr"
    }
]
国家 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/15077/idealista+api/40029/countries' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
列出了“property_type”参数接受的值,每个值都有其标签和可用的操作(“sale”,“rent”)
Endpoint ID: 40030
GET https://zylalabs.com/api/15077/idealista+api/40030/property+types
输入参数

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

此端点不需要任何输入参数。

API 示例响应
JSON
[
    {
        "value": "homes",
        "label": "Houses and flats",
        "operations": [
            "sale",
            "rent"
        ]
    },
    {
        "value": "newDevelopments",
        "label": "New developments",
        "operations": [
            "sale",
            "rent"
        ]
    },
    {
        "value": "luxury",
        "label": "Luxury homes",
        "operations": [
            "sale"
        ]
    },
    {
        "value": "bedrooms",
        "label": "Rooms in shared flats",
        "operations": [
            "rent"
        ]
    },
    {
        "value": "vacationRentals",
        "label": "Vacation rentals",
        "operations": [
            "rent"
        ]
    },
    {
        "value": "offices",
        "label": "Offices",
        "operations": [
            "sale",
            "rent"
        ]
    },
    {
        "value": "premises",
        "label": "Commercial premises",
        "operations": [
            "sale",
            "rent"
        ]
    },
    {
        "value": "transfers",
        "label": "Business transfers",
        "operations": [
            "sale"
        ]
    },
    {
        "value": "garages",
        "label": "Garages and parking spaces",
        "operations": [
            "sale",
            "rent"
        ]
    },
    {
        "value": "lands",
        "label": "Land",
        "operations": [
            "sale",
            "rent"
        ]
    },
    {
        "value": "storageRooms",
        "label": "Storage rooms",
        "operations": [
            "sale",
            "rent"
        ]
    },
    {
        "value": "buildings",
        "label": "Buildings",
        "operations": [
            "sale",
            "rent"
        ]
    }
]
物业类型 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/15077/idealista+api/40030/property+types' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
列出了/property/search端点“sort”参数接受的值
Endpoint ID: 40031
GET https://zylalabs.com/api/15077/idealista+api/40031/sort+orders
输入参数

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

此端点不需要任何输入参数。

API 示例响应
JSON
[
    "relevance",
    "price_asc",
    "price_desc",
    "size_asc",
    "size_desc",
    "rooms_asc",
    "rooms_desc",
    "newest",
    "oldest",
    "price_per_m2_asc",
    "price_per_m2_desc",
    "price_drop"
]
排序订单 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/15077/idealista+api/40031/sort+orders' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
查找与文本查询匹配的国家位置:每个结果都携带由/property/search端点的“location_id”参数接受的位置ID、名称、类型(省、县、市、区或社区)、是否细分为更小的位置以及其中列出的物业数量
Endpoint ID: 40032
GET https://zylalabs.com/api/15077/idealista+api/40032/location+autocomplete
输入参数

地点自动补全 — 端点功能

对象 描述
country 必需 Country code: "es" (Spain), "it" (Italy), "pt" (Portugal) or "fr" (France). Use the /general/countries endpoint to list valid values.
query 必需 Text to match against location names (e.g. "madrid").
operation 可选 Optional operation the property counts refer to: "sale" or "rent" (defaults to "sale").
property_type 可选 Optional property type the property counts refer to (defaults to "homes"). Use the /general/property-types endpoint to list valid values.
language 可选 Optional language of the texts (defaults to "en"): "en", "es", "it", "pt", "fr", "de", "ca", "nl", "pl", "ro", "ru", "sv", "da", "fi", "nb", "el", "uk" or "zh".

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


输入参数

country
query
operation
property_type
language
API 示例响应
JSON
[
    {
        "location_id": "0-EU-ES-28-07-001-079",
        "name": "Madrid, Madrid",
        "type": "Municipality",
        "divisible": true,
        "property_count": 20181
    },
    {
        "location_id": "0-EU-ES-28",
        "name": "Madrid",
        "type": "Province",
        "divisible": true,
        "property_count": 34376
    },
    {
        "location_id": "0-EU-ES-28-02-005-127",
        "name": "Las Rozas de Madrid, Madrid",
        "type": "Municipality",
        "divisible": true,
        "property_count": 568
    },
    {
        "location_id": "0-EU-ES-28-04-008-073",
        "name": "Humanes de Madrid, Madrid",
        "type": "Municipality",
        "divisible": false,
        "property_count": 75
    },
    {
        "location_id": "0-EU-ES-26-01-001-089-13",
        "name": "Zona Avda. de Madrid, Logroño",
        "type": "District",
        "divisible": false,
        "property_count": 49
    },
    {
        "location_id": "0-EU-ES-23-07-001-050-05",
        "name": "Avda de Madrid - Pº de la Estación, Jaén",
        "type": "District",
        "divisible": false,
        "property_count": 28
    },
    {
        "location_id": "0-EU-ES-45-08-001-087",
        "name": "Madridejos, Toledo",
        "type": "Municipality",
        "divisible": false,
        "property_count": 40
    },
    {
        "location_id": "0-EU-ES-49-02-001-103",
        "name": "Madridanos, Zamora",
        "type": "Municipality",
        "divisible": false,
        "property_count": 1
    },
    {
        "location_id": "0-EU-ES-28-05-001-123",
        "name": "Rivas-Vaciamadrid, Madrid",
        "type": "Municipality",
        "divisible": true,
        "property_count": 218
    },
    {
        "location_id": "0-EU-ES-28-01-016-104-04",
        "name": "Miramadrid, Paracuellos de Jarama",
        "type": "District",
        "divisible": false,
        "property_count": 26
    }
]
地点自动补全 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/15077/idealista+api/40032/location+autocomplete?country=es&query=madrid&operation=sale&property_type=homes&language=en' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
列出一个地区细分的地点,以便从省份浏览国家到市、区和社区:地点 ID名称类型是否进一步细分以及其中列出的属性数量。如果没有地点 ID,它将列出国家的顶级地点
Endpoint ID: 40033
GET https://zylalabs.com/api/15077/idealista+api/40033/locations+of+a+country+or+location
输入参数

一个国家或地点的位置 — 端点功能

对象 描述
country 必需 Country code: "es" (Spain), "it" (Italy), "pt" (Portugal) or "fr" (France). Use the /general/countries endpoint to list valid values.
location_id 可选 Optional location id to list the locations of (e.g. "0-EU-ES-28" for the province of Madrid). Without it the top-level locations of the country are listed.
operation 可选 Optional operation the property counts refer to: "sale" or "rent" (defaults to "sale").
property_type 可选 Optional property type the property counts refer to (defaults to "homes"). Use the /general/property-types endpoint to list valid values.
language 可选 Optional language of the texts (defaults to "en"): "en", "es", "it", "pt", "fr", "de", "ca", "nl", "pl", "ro", "ru", "sv", "da", "fi", "nb", "el", "uk" or "zh".

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


输入参数

country
location_id
operation
property_type
language
API 示例响应
JSON
[
    {
        "location_id": "0-EU-ES-28-06",
        "name": "Corredor del Henares, Madrid",
        "type": "County",
        "divisible": true,
        "property_count": 1874
    },
    {
        "location_id": "0-EU-ES-28-07-001-079",
        "name": "Madrid, Madrid",
        "type": "Municipality",
        "divisible": true,
        "property_count": 20181
    },
    {
        "location_id": "0-EU-ES-28-02",
        "name": "Zona noroeste, Madrid",
        "type": "County",
        "divisible": true,
        "property_count": 3807
    },
    {
        "location_id": "0-EU-ES-28-01",
        "name": "Zona norte, Madrid",
        "type": "County",
        "divisible": true,
        "property_count": 2465
    },
    {
        "location_id": "0-EU-ES-28-04",
        "name": "Zona sur, Madrid",
        "type": "County",
        "divisible": true,
        "property_count": 3875
    },
    {
        "location_id": "0-EU-ES-28-05",
        "name": "Zona sureste, Madrid",
        "type": "County",
        "divisible": true,
        "property_count": 1290
    },
    {
        "location_id": "0-EU-ES-28-03",
        "name": "Zona suroeste, Madrid",
        "type": "County",
        "divisible": true,
        "property_count": 884
    }
]
一个国家或地点的位置 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/15077/idealista+api/40033/locations+of+a+country+or+location?country=es&location_id=0-EU-ES-28&operation=sale&property_type=homes&language=en' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
返回一个位置的边界作为GeoJSON几何体(经度,纬度对)
Endpoint ID: 40034
GET https://zylalabs.com/api/15077/idealista+api/40034/location+boundary
输入参数

位置边界 — 端点功能

对象 描述
country 必需 Country code: "es" (Spain), "it" (Italy), "pt" (Portugal) or "fr" (France). Use the /general/countries endpoint to list valid values.
location_id 必需 Location id (e.g. "0-EU-ES-28" for the province of Madrid). Use the /location/search or /location/list endpoint to find it.

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


输入参数

country
location_id
API 示例响应
JSON
{
    "location_id": "0-EU-ES-28",
    "geojson": {
        "type": "MultiPolygon",
        "coordinates": [
            [
                [
                    [
                        -3.607742,
                        40.10881
                    ],
                    [
                        -3.612499,
                        40.111403
                    ],
                    [
                        -3.616296,
                        40.112494
                    ],
                    [
                        -3.621184,
                        40.115227
                    ],
                    [
                        -3.622067,
                        40.113363
                    ],
                    [
                        -3.624698,
                        40.114391
                    ],
                    [
                        -3.626729,
                        40.11678
                    ],
                    [
                        -3.628978,
                        40.117911
                    ],
                    [
                        -3.633592,
                        40.118952
                    ],
                    [
                        -3.633885,
                        40.119066
                    ],
                    [
                        -3.639074,
                        40.120491
                    ],
                    [
                        -3.656127,
                        40.125277
                    ],
                    [
                        -3.656218,
                        40.125684
                    ],
                    [
                        -3.656793,
                        40.127846
                    ],
                    [
                        -3.660015,
                        40.128347
                    ],
                    [
                        -3.665861,
                        40.136399
                    ],
                    [
                        -3.666847,
                        40.143516
                    ],
                    [
                        -3.678288,
                        40.139112
                    ],
                    [
                        -3.679926,
                        40.137077
                    ],
                    [
                        -3.683601,
                        40.132493
                    ],
                    [
                        -3.69092,
                        40.13276
                    ],
                    [
                        -3.691023,
                        40.132754
                    ],
                    [
                        -3.708907,
                        40.140269
                    ],
                    [
                        -3.712837,
                        40.141896
                    ],
                    [
                        -3.712201,
                        40.142819
                    ],
                    [
                        -3.715204,
                        40.144735
                    ],
                    [
                        -3.718052,
                        40.146538
                    ],
                    [
                        -3.720568,
                        40.147965
                    ],
                    [
                        -3.723574,
                        40.147117
                    ],
                    [
                        -3.742042,
                        40.13419
                    ],
                    [
                        -3.74503,
                        40.132656
                    ],
                    [
                        -3.771778,
                        40.139587
                    ],
                    [
                        -3.772334,
                        40.142099
                    ],
                    [
                        -3.772393,
                        40.142255
                    ],
                    [
                        -3.778125,
                        40.147582
                    ],
                    [
                        -3.77819,
                        40.147724
                    ],
                    [
                        -3.7789,
                        40.15583
                    ],
                    [
                        -3.784145,
                        40.162598
                    ],
                    [
                        -3.784215,
                        40.162716
                    ],
                    [
                        -3.794082,
                        40.170799
                    ],
                    [
                        -3.799933,
                        40.175628
                    ],
                    [
                        -3.800069,
                        40.175704
                    ],
                    [
                        -3.805985,
                        40.177503
                    ],
                    [
                        -3.806687,
                        40.177272
                    ],
                    [
                        -3.810209,
                        40.169129
                    ],
                    [
                        -3.81366,
                        40.170198
                    ],
                    [
                        -3.817294,
                        40.171376
                    ],
                    [
                        -3.823677,
                        40.167707
                    ],
                    [
                        -3.834689,
                        40.161473
                    ],
                    [
                        -3.837891,
                        40.162018
                    ],
                    [
                        -3.840822,
                        40.162659
                    ],
                    [
                        -3.841013,
                        40.162547
                    ],
                    [
                        -3.852717,
                        40.169681
                    ],
                    [
                        -3.851114,
                        40.177829
                    ],
                    [
                        -3.853371,
                        40.179775
                    ],
                    [
                        -3.864905,
                        40.187175
                    ],
                    [
                        -3.876151,
                        40.191121
                    ],
                    [
                        -3.877653,
                        40.188233
                    ],
                    [
                        -3.883173,
                        40.189019
                    ],
                    [
                        -3.894329,
                        40.188743
                    ],
                    [
                        -3.899366,
                        40.190453
                    ],
                    [
                        -3.910155,
                        40.189837
                    ],
                    [
                        -3.915769,
                        40.191499
                    ],
                    [
                        -3.925211,
                        40.200062
                    ],
                    [
                        -3.930918,
                        40.203979
                    ],
                    [
                        -3.935741,
                        40.202671
                    ],
                    [
                        -3.938312,
                        40.203448
                    ],
                    [
                        -3.941104,
                        40.198006
                    ],
                    [
                        -3.945484,
                        40.194542
                    ],
                    [
                        -3.949215,
                        40.189124
                    ],
                    [
                        -3.951171,
                        40.190339
                    ],
                    [
                        -3.950802,
                        40.196663
                    ],
                    [
                        -3.956128,
                        40.198594
                    ],
                    [
                        -3.952853,
                        40.212335
                    ],
                    [
                        -3.977073,
                        40.212392
                    ],
                    [
                        -3.992348,
                        40.209732
                    ],
                    [
                        -3.998766,
                        40.216298
                    ],
                    [
                        -4.009241,
                        40.220601
                    ],
                    [
                        -4.020513,
                        40.230846
                    ]
                ]
            ]
        ]
    }
}
位置边界 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/15077/idealista+api/40034/location+boundary?country=es&location_id=0-EU-ES-28' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
列出西班牙 意大利 葡萄牙 或 法国某个位置或某个点半径内待售或出租的房产:房产ID 链接 标题 房产类型 价格 每平方米价格 价格下跌 面积 房间 浴室 楼层 描述 标签 地址 坐标 特征 停车位 带房间标签的照片 视频 虚拟导览和广告商。返回房产总数和页数。价格以欧元为单位 面积以平方米为单位
Endpoint ID: 40035
GET https://zylalabs.com/api/15077/idealista+api/40035/search+properties
输入参数

搜索房产 — 端点功能

对象 描述
min_size 可选 Optional minimum size in square meters.
page 可选 Optional page number, 50 properties per page, up to 50 pages (defaults to 1).
sort 可选 Optional sort order (defaults to "relevance"). Use the /general/sort-orders endpoint to list valid values.
keyword 可选 Optional text to look for in the listings (e.g. "piscina").
published 可选 Optional publication period: "last_24_hours" (operation "rent" only), "last_48_hours" (operation "sale" only), "last_week" or "last_month".
condition 可选 Optional condition, one or more values separated by commas: "new", "good" or "needs_renovation".
home_type 可选 Optional home types, one or more values separated by commas: "flat", "penthouse", "duplex", "house", "detached_house", "semi_detached_house", "terraced_house", "country_house", "villa", "apartment", "loft", "attic", "single_storey_house", "stone_house" or "cortijo".
bathrooms 可选 Optional number of bathrooms, one or more values separated by commas: "1", "2" or "3" (3 or more).
bedrooms 可选 Optional number of bedrooms, one or more values separated by commas: "0" (studio), "1", "2", "3" or "4" (4 or more). E.g. "2,3".
max_size 可选 Optional maximum size in square meters.
country 必需 Country code: "es" (Spain), "it" (Italy), "pt" (Portugal) or "fr" (France). Use the /general/countries endpoint to list valid values.
max_price 可选 Optional maximum price in euros (monthly rent for operation "rent").
min_price 可选 Optional minimum price in euros (monthly rent for operation "rent").
property_type 可选 Optional property type (defaults to "homes"). Use the /general/property-types endpoint to list valid values and the operations each one is available with.
radius 可选 Optional search radius around the center point in meters, between 1 and 50000 (defaults to 1000).
longitude 可选 Longitude of the center point (e.g. "-3.7038"). Given together with "latitude".
latitude 可选 Latitude of the center point, to search around a point instead of in a location (e.g. "40.4168"). Given together with "longitude".
location_id 可选 Location id (e.g. "0-EU-ES-28" for the province of Madrid). Required unless "latitude" and "longitude" are given. Use the /location/search or /location/list endpoint to find it.
operation 必需 Operation: "sale" or "rent".

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


输入参数

min_size
page
sort
keyword
published
condition
home_type
bathrooms
bedrooms
max_size
country
max_price
min_price
property_type
radius
longitude
latitude
location_id
operation
API 示例响应
JSON
{
    "country": "es",
    "operation": "sale",
    "property_type": "homes",
    "location_id": "0-EU-ES-28",
    "title": "Madrid province",
    "total": 34377,
    "page": 1,
    "page_size": 50,
    "total_pages": 50,
    "properties": [
        {
            "id": "106387165",
            "url": "https://www.idealista.com/inmueble/106387165/",
            "title": "Penthouse in Goya, Madrid",
            "property_type": "flat",
            "property_subtype": "penthouse",
            "operation": "sale",
            "price": 3390000,
            "currency": "EUR",
            "price_period": null,
            "price_per_m2": 12890,
            "price_drop": null,
            "size_m2": 263,
            "rooms": 4,
            "bathrooms": 5,
            "guests": null,
            "floor": "5",
            "exterior": true,
            "has_lift": true,
            "status": "good",
            "new_development": false,
            "development_name": null,
            "description": "We present to you EXCLUSIVELY a unique property on the top floor of a royal estate with an exceptional location. La Casa de las Bolas, also known as the Casa de los Picos, is a unique building located in the Salamanca neighborhood, in Madrid. Its name comes from the peculiar façade adorned with protruding stone bollards or “balls”, a feature that gives it a distinctive and striking appearance compared to the architectural style of the surrounding buildings. This peculiar design responds to a mix of historical and artistic influences, which have given rise to a unique structure of its kind and an object of curiosity for those who visit the area.  Built at the beginning of the 20th century, the Casa de las Bolas was designed by architect Julio Martínez Zapata, known for his modernist approach and his ability to integrate innovative and decorative elements in his works. The building has several floors, and its façade is decorated with a series of stone balls that run throughout its exterior in an orderly manner, generating an impressive visual effect.   In addition to its unique façade, the Casa de las Bolas has a structure and interior layout typical of buildings from the early 20th century in Madrid, with high ceilings, large windows and a spacious layout. However, the particularity of its external design makes it a point of interest for photographers, architects and tourists looking for historical and curious buildings in the Spanish capital.  Today, the Casa de las Bolas is a symbol of the Salamanca neighborhood and a leading example of the unique architecture that can be found in Madrid, reminding us of the rich architectural history and creativity of urban designs that have shaped this city.  Currently being renovated, this spacious home has six bedrooms and four bathrooms.   This unique and unique home has 14 balconies facing the street, in addition to its magnificent south-east, west orientation, it offers you, as it is a corner and with height, an unmatched luminosity, from where you can see the skyline of Madrid from an unbeatable situation. A few meters from Retiro Park, the green lung of the city.   Don't miss this investment opportunity in one of the most sought-after areas. Contact us for more information and to schedule a visit!  Walter Haus Real Estate is a real estate group based in the main capitals of Spain, in the main locations of Madrid, Barcelona and Costa Brava.  We have more than 20 years of experience, with a dynamic team of professionals with experience in personal advice in constant training and with a very specific specialization in each area of action, which allows us to find solutions to the needs of each client.   Walter Haus Real Estate is a real estate group based in the main capitals of Spain, in the main locations of Madrid, Barcelona and Costa Brava.  We have more than 20 years of experience, with a dynamic team of professionals with experience in personal advice in constant training and with a very specific specialization in each area of action, which allows us to find solutions to the needs of each client.",
            "labels": [
                "Luxury"
            ],
            "address": "Penthouse in Goya, Madrid",
            "province": "Madrid",
            "municipality": "Madrid",
            "district": "Barrio de Salamanca",
            "neighborhood": "Goya",
            "location_id": "0-EU-ES-28-07-001-079-04-002",
            "latitude": 40.4233982,
            "longitude": -3.6760023,
            "exact_location": false,
            "features": {
                "swimming_pool": false,
                "terrace": true,
                "air_conditioning": true,
                "garden": false,
                "storage_room": false
            },
            "parking": null,
            "reviews": null,
            "thumbnail": "https://img4.idealista.com/s/v1/yLueJcFaPGYMndqtd3fIzo9BdwYl4inLwTKbMiVSdz4l4khBqGDIaJvI4s5m5JvBd6j3d3o-dz61dwYIenr3Pj4LegjI9Zuoyw?Expires=1795173156&Signature=MEQCIDvleCLQzNOiHEnaDFicbRGjJWJ0~PluZ6A29qmI6~NAAiByngk8-tZ59qJbxs6VvvHt14b7Y-CF-dlxAFVPncPiag__&Key-Pair-Id=K20EOYVFELHOX5",
            "photo_count": 72,
            "has_video": true,
            "has_plan": true,
            "has_3d_tour": true,
            "has_360": false,
            "images": [
                {
                    "url": "https://img4.idealista.com/s/v1/yLueJcFaPGYMndqtd3fIzo9BdwYl4inLwTKbMiVSdz4l4khBqGDIaJvI4s5m5JvBd6j3d3o-dz61dwYIenr3Pj4LegjI9Zuoyw?Expires=1795173156&Signature=MEQCIBdvYCPLPsaDrybhbrWfq8o2qbQK7YfvUeWkIgwzcStRAiAHNeKUAZz8UVx3YQMhHoRcPOY-U-uvN4HJs4KpMFsmZQ__&Key-Pair-Id=K20EOYVFELHOX5",
                    "tag": "livingRoom"
                }
            ],
            "videos": [
                {
                    "url": "https://st3v.idealista.com/5d/01/53/1382161016.mp4",
                    "thumbnail": "https://st3v.idealista.com/5d/01/53/1382161016.jpg"
                }
            ],
            "virtual_tours": [
                {
                    "url": "https://my.matterport.com/show/?m=7QZpQ36rzZU&lang=en",
                    "type": "3d",
                    "thumbnail": "https://img4.idealista.com/s/v1/yLueJcFaPGYMndqtd3fIzo9BdwYl4inLwTKbMiVSdz4l4khBqGDIaJvI4s5m5JvBd6j3d3o-dz61dwYIenr3Pj4LegjI9Zuoyw?Expires=1795173156&Signature=MEQCIBdvYCPLPsaDrybhbrWfq8o2qbQK7YfvUeWkIgwzcStRAiAHNeKUAZz8UVx3YQMhHoRcPOY-U-uvN4HJs4KpMFsmZQ__&Key-Pair-Id=K20EOYVFELHOX5"
                }
            ],
            "advertiser": {
                "type": "professional",
                "name": "Walter Haus",
                "commercial_name": "Walter Haus Madrid",
                "reference": "M11468V",
                "phone": "+34919385698",
                "logo": "https://st3.idealista.com/ff/20/20/walterhauschamberi.gif",
                "agency_id": "walterhauschamberi",
                "address": null
            },
            "published_at": null
        }
    ]
}
搜索房产 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/15077/idealista+api/40035/search+properties?page=1&sort=relevance&country=es&property_type=homes&location_id=0-EU-ES-28&operation=sale' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
返回完整的单个属性:链接、标题、操作、物业类型、价格、每平方米价格、社区费用、面积、房间、浴室、楼层、特点、描述、布局、特征、标签、能源证书、带坐标的地址、带房间标签和尺寸的照片、视频、虚拟导览、广告商和最后更新。一个新开发项目还列出了其单元,度假出租列出了其客人、评论和房规。价格以欧元计,面积以平方米计
Endpoint ID: 40036
GET https://zylalabs.com/api/15077/idealista+api/40036/property+details
输入参数

物业详情 — 端点功能

对象 描述
country 必需 Country code: "es" (Spain), "it" (Italy), "pt" (Portugal) or "fr" (France). Use the /general/countries endpoint to list valid values.
property_id 必需 Property id (e.g. "106387165"). Use the /property/search endpoint to list valid values.
property_type 可选 Optional property type the id belongs to. Only needed for a vacation rental: pass "vacationRentals".
language 可选 Optional language of the texts (defaults to "en"): "en", "es", "it", "pt", "fr", "de", "ca", "nl", "pl", "ro", "ru", "sv", "da", "fi", "nb", "el", "uk" or "zh".

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


输入参数

country
property_id
property_type
language
API 示例响应
JSON
{
    "id": "106387165",
    "country": "es",
    "url": "https://www.idealista.com/inmueble/106387165/",
    "external_url": "https://walterhaus.es/inmueble/piso-exterior-en-venta-totalmente-reformado-a-estrenar-en-goya-madrid-m11468v/",
    "title": "Penthouse for sale in Goya",
    "headline": "Piso exterior en venta a reformar en Goya, Madrid",
    "operation": "sale",
    "property_type": "flat",
    "property_subtype": "penthouse",
    "state": "active",
    "price": 3390000,
    "currency": "EUR",
    "price_period": null,
    "price_per_m2": 12890,
    "community_costs": 320,
    "size_m2": 263,
    "usable_size_m2": null,
    "plot_size_m2": null,
    "rooms": 4,
    "bathrooms": 5,
    "guests": null,
    "floor": "5",
    "floor_location": "external",
    "exterior": true,
    "has_lift": true,
    "garden": false,
    "swimming_pool": false,
    "storage_room": false,
    "furnished": "unknown",
    "pets_allowed": null,
    "construction_year": null,
    "is_auction": false,
    "bank_owned": false,
    "status": "good",
    "available_from": null,
    "description": "We present to you EXCLUSIVELY a unique property on the top floor of a royal estate with an exceptional location. La Casa de las Bolas, also known as the Casa de los Picos, is a unique building located in the Salamanca neighborhood, in Madrid. Its name comes from the peculiar façade adorned with protruding stone bollards or “balls”, a feature that gives it a distinctive and striking appearance compared to the architectural style of the surrounding buildings. This peculiar design responds to a mix of historical and artistic influences, which have given rise to a unique structure of its kind and an object of curiosity for those who visit the area.\n\n Built at the beginning of the 20th century, the Casa de las Bolas was designed by architect Julio Martínez Zapata, known for his modernist approach and his ability to integrate innovative and decorative elements in his works. The building has several floors, and its façade is decorated with a series of stone balls that run throughout its exterior in an orderly manner, generating an impressive visual effect. \n\n In addition to its unique façade, the Casa de las Bolas has a structure and interior layout typical of buildings from the early 20th century in Madrid, with high ceilings, large windows and a spacious layout. However, the particularity of its external design makes it a point of interest for photographers, architects and tourists looking for historical and curious buildings in the Spanish capital.\n\n Today, the Casa de las Bolas is a symbol of the Salamanca neighborhood and a leading example of the unique architecture that can be found in Madrid, reminding us of the rich architectural history and creativity of urban designs that have shaped this city.\n\n Currently being renovated, this spacious home has six bedrooms and four bathrooms. \n This unique and unique home has 14 balconies facing the street, in addition to its magnificent south-east, west orientation, it offers you, as it is a corner and with height, an unmatched luminosity, from where you can see the skyline of Madrid from an unbeatable situation. A few meters from Retiro Park, the green lung of the city. \n\n Don't miss this investment opportunity in one of the most sought-after areas. Contact us for more information and to schedule a visit!\n\n Walter Haus Real Estate is a real estate group based in the main capitals of Spain, in the main locations of Madrid, Barcelona and Costa Brava.\n\n We have more than 20 years of experience, with a dynamic team of professionals with experience in personal advice in constant training and with a very specific specialization in each area of action, which allows us to find solutions to the needs of each client. \n Walter Haus Real Estate is a real estate group based in the main capitals of Spain, in the main locations of Madrid, Barcelona and Costa Brava.\n\n We have more than 20 years of experience, with a dynamic team of professionals with experience in personal advice in constant training and with a very specific specialization in each area of action, which allows us to find solutions to the needs of each client.",
    "description_language": "en",
    "layout": "5th floor exterior with lift",
    "floor_description": "5th floor",
    "characteristics": [
        {
            "title": "The advertiser considers it appropriate for",
            "features": [
                "People with reduced mobility (Only exterior access is adapted)"
            ]
        },
        {
            "title": "Basic features",
            "features": [
                "263 m² constructed",
                "4 bedrooms",
                "5 bathrooms",
                "Terrace and balcony",
                "Second hand/good condition",
                "Fitted wardrobes",
                "Orientation south, east, west",
                "Built in 1889",
                "Individual heating: Natural gas"
            ]
        },
        {
            "title": "Building",
            "features": [
                "5th floor exterior",
                "With lift"
            ]
        },
        {
            "title": "Equipment",
            "features": [
                "Air conditioning"
            ]
        },
        {
            "title": "Price",
            "features": [
                "Property price: € 3,390,000",
                "Price per m²: 12,890 €/m²",
                "320 € in community costs"
            ]
        }
    ],
    "labels": [
        "Luxury"
    ],
    "energy_certificate": {
        "consumption": {
            "rating": "B",
            "value": 214.6,
            "label": "214.6 kwh/m² year"
        },
        "emissions": {
            "rating": "B",
            "value": 44.8,
            "label": "44.8 kg CO2/m² year"
        }
    },
    "location": {
        "address": null,
        "area": "District Barrio de Salamanca, Madrid",
        "building": "edificio de las bolas",
        "latitude": 40.4233982,
        "longitude": -3.6760023,
        "exact_location": false,
        "location_id": "0-EU-ES-28-07-001-079-04-002",
        "levels": [
            "Madrid capital, Madrid",
            "Madrid",
            "District Barrio de Salamanca",
            "Subdistrict Goya"
        ]
    },
    "reviews": null,
    "house_rules": null,
    "units": [],
    "images": [
        {
            "url": "https://img4.idealista.com/s/v1/yLv6QcHaG8GQdXf-iXclZqDGd1k6LVp3MsjLdXX8iZCym0gHqPJayDLizmibyOLOZuSbwXeo93d6Pnc-tXcGCHp69z4-C3oIyPWbqMs?Expires=1795173154&Signature=MEUCIQC1-NFfD~bIYTmJfK24eoYqMECOBifCBPDX8E6ml04f-wIgFiVmbDvt3gKXQf96JH~Z0lZSNtDATg~PFpnEvp~w4VM_&Key-Pair-Id=K20EOYVFELHOX5",
            "tag": "livingRoom",
            "label": "Living room",
            "width": 1500,
            "height": 1000
        },
        {
            "url": "https://img4.idealista.com/s/v1/yLv6QcHaG8GQdXf-iXclZqDGd1k6LVp3MsjLdXX8iZCym0gHqPJayDLizmibyOLOZuSbwXcl93c-C3eogHcGCHp69z4-Cwj3yPWbqMs?Expires=1795173154&Signature=MEYCIQDXXYm3fLCx-i2M2KmtPeMFSAZzly6nN22SGcq7h87tpwIhAKhg7RT-KrOfG9tBBIBS2yoqUESAPkcZYxDfiQzpd9sk&Key-Pair-Id=K20EOYVFELHOX5",
            "tag": "livingRoom",
            "label": "Living room",
            "width": 1500,
            "height": 1000
        }
    ],
    "videos": [
        {
            "url": "https://st3v.idealista.com/5d/01/53/1382161016.mp4",
            "thumbnail": "https://st3v.idealista.com/5d/01/53/1382161016.jpg"
        }
    ],
    "virtual_tours": [
        {
            "url": "https://my.matterport.com/show/?m=7QZpQ36rzZU&lang=en",
            "type": "3d",
            "thumbnail": "https://img4.idealista.com/s/v1/yLv6QcHaG8GQdXf-iXclZqDGd1k6LVp3MsjLdXX8iZCym0gHqPJayDLizmibyOLOZuSbwXcl93c-C3eogHcGCHp69z4-Cwj3yPWbqMs?Expires=1795173154&Signature=MEQCIAZvSO1-uBhUadWAf-Ag6jQuM8SmsHLr8zIQp2gcHOoSAiAb8ChM4yGvL~SJQVoAkdb3s~8vPf3U8fR9SI0NjOsGog__&Key-Pair-Id=K20EOYVFELHOX5"
        }
    ],
    "advertiser": {
        "type": "professional",
        "name": "Walter Haus Salamanca",
        "commercial_name": "Walter Haus Madrid",
        "reference": "M11468V",
        "phone": "+34919385698",
        "logo": "https://st3.idealista.com/ff/20/20/walterhauschamberi.gif",
        "agency_id": "walterhauschamberi",
        "address": {
            "street": "Paseo General Martinez Campos",
            "number": "13",
            "postal_code": "28010",
            "city": "Madrid"
        }
    },
    "updated_at": "2026-11-13T10:18:15+00:00"
}
物业详情 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/15077/idealista+api/40036/property+details?country=es&property_id=106387165&language=en' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
列出与给定房产相似的房产,每个房产包括房产ID 链接 标题 房产类型 价格 每平方米价格 价格下跌 面积 房间 浴室 楼层 描述 标签 地址 坐标 特征 停车 照片及其房间标签 视频 虚拟游览 和广告商 价格以欧元为单位 面积以平方米为单位
Endpoint ID: 40037
GET https://zylalabs.com/api/15077/idealista+api/40037/similar+properties
输入参数

相似属性 — 端点功能

对象 描述
country 必需 Country code: "es" (Spain), "it" (Italy), "pt" (Portugal) or "fr" (France). Use the /general/countries endpoint to list valid values.
property_id 必需 Property id (e.g. "113109809"). Use the /property/search endpoint to list valid values.
language 可选 Optional language of the texts (defaults to "en"): "en", "es", "it", "pt", "fr", "de", "ca", "nl", "pl", "ro", "ru", "sv", "da", "fi", "nb", "el", "uk" or "zh".

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


输入参数

country
property_id
language
API 示例响应
JSON
[
    {
        "id": "111514005",
        "url": "https://www.idealista.com/inmueble/111514005/",
        "title": "Flat / apartment in Calle de Ardemans, Guindalera, Madrid",
        "property_type": "flat",
        "property_subtype": null,
        "operation": "sale",
        "price": 420000,
        "currency": "EUR",
        "price_period": null,
        "price_per_m2": 7778,
        "price_drop": null,
        "size_m2": 54,
        "rooms": 2,
        "bathrooms": 1,
        "guests": null,
        "floor": "7",
        "exterior": false,
        "has_lift": true,
        "status": "good",
        "new_development": false,
        "development_name": null,
        "description": "Magnificent, very bright home, fully renovated and ready to move into, located on Calle Ardemans, in one of the most sought-after areas of Madrid. The property has an approximate area of 54 m² distributed into two bedrooms, a cozy attic-style living room, a fully furnished and equipped kitchen, and a full bathroom with a shower. It features central natural gas heating and air conditioning, ensuring maximum comfort throughout the year. Additionally, it has parquet floors, built-in wardrobes, and a reinforced door. Located in a building with an elevator and concierge service. Excellent location and transport links, just 40 meters from the Diego de León metro station (lines 4, 5, and 6) and very close to Parque de las Avenidas (line 7), with quick connections to the entire Madrid Metro network. It is also near the Avenida de América transport hub, with access to the metro, urban and interurban buses, and direct connections to the airport, train stations, and various points in the capital. The area also offers excellent road connections, with quick access to the M-30 and easy entry to the center of Madrid and the city's main business districts. Surrounded by all services, shops, restaurants, and leisure areas. Ideal both as a primary residence and as an investment.",
        "labels": [],
        "address": "Flat / apartment in Calle de Ardemans, Guindalera, Madrid",
        "province": "Madrid",
        "municipality": "Madrid",
        "district": "Barrio de Salamanca",
        "neighborhood": "Guindalera",
        "location_id": "0-EU-ES-28-07-001-079-04-004",
        "latitude": 40.4362523,
        "longitude": -3.6740976,
        "exact_location": false,
        "features": {
            "swimming_pool": false,
            "terrace": false,
            "air_conditioning": true,
            "garden": false,
            "storage_room": false
        },
        "parking": null,
        "reviews": null,
        "thumbnail": "https://img4.idealista.com/blur/480_360_mq/0/id.pro.es.image.master/bd/5a/84/1438976852.webp",
        "photo_count": 27,
        "has_video": true,
        "has_plan": true,
        "has_3d_tour": true,
        "has_360": true,
        "images": [
            {
                "url": "https://img4.idealista.com/blur/480_360_mq/0/id.pro.es.image.master/bd/5a/84/1438976852.webp",
                "tag": "livingRoom"
            },
            {
                "url": "https://img4.idealista.com/blur/480_360_mq/0/id.pro.es.image.master/96/f6/56/1438976969.webp",
                "tag": "kitchen"
            },
            {
                "url": "https://img4.idealista.com/blur/480_360_mq/0/id.pro.es.image.master/44/a4/c0/1438976974.webp",
                "tag": "bedroom"
            },
            {
                "url": "https://img4.idealista.com/blur/480_360_mq/0/id.pro.es.image.master/62/2c/b8/1438976972.webp",
                "tag": "bathroom"
            },
            {
                "url": "https://img4.idealista.com/blur/480_360_mq/0/id.pro.es.image.master/b3/37/81/1438976961.webp",
                "tag": "livingRoom"
            },
            {
                "url": "https://img4.idealista.com/blur/480_360_mq/0/id.pro.es.image.master/8a/27/d0/1438976963.webp",
                "tag": "livingRoom"
            },
            {
                "url": "https://img4.idealista.com/blur/480_360_mq/0/id.pro.es.image.master/af/73/c1/1438976975.webp",
                "tag": "bedroom"
            },
            {
                "url": "https://img4.idealista.com/blur/480_360_mq/0/id.pro.es.image.master/49/25/0e/1438976971.webp",
                "tag": "bedroom"
            },
            {
                "url": "https://img4.idealista.com/blur/480_360_mq/0/id.pro.es.image.master/89/47/fb/1438976933.webp",
                "tag": "livingRoom"
            },
            {
                "url": "https://img4.idealista.com/blur/480_360_mq/0/id.pro.es.image.master/e8/38/3e/1438976853.webp",
                "tag": "livingRoom"
            },
            {
                "url": "https://img4.idealista.com/blur/480_360_mq/0/id.pro.es.image.master/3e/40/ed/1438976965.webp",
                "tag": "kitchen"
            },
            {
                "url": "https://img4.idealista.com/blur/480_360_mq/0/id.pro.es.image.master/be/3a/c0/1438976966.webp",
                "tag": "diningRoom"
            },
            {
                "url": "https://img4.idealista.com/blur/480_360_mq/0/id.pro.es.image.master/d6/a5/cb/1438976967.webp",
                "tag": "kitchen"
            }
        ],
        "videos": [
            {
                "url": "https://st3v.idealista.com/94/5d/69/1440356739.mp4",
                "thumbnail": "https://st3v.idealista.com/94/5d/69/1440356739.jpg"
            },
            {
                "url": "https://st3v.idealista.com/db/20/62/1438977174.mp4",
                "thumbnail": "https://st3v.idealista.com/db/20/62/d_0_1438977174.jpg"
            }
        ],
        "virtual_tours": [
            {
                "url": "https://my.matterport.com/show/?m=Wm2HhYcEB8f&lang=en",
                "type": "3d",
                "thumbnail": "https://img4.idealista.com/blur/480_360_mq/0/id.pro.es.image.master/96/f6/56/1438976969.webp"
            },
            {
                "url": "https://floorfy.com/es/tour/2625554?play=no&lang=en",
                "type": "360",
                "thumbnail": "https://img4.idealista.com/blur/480_360_mq/0/id.pro.es.image.master/96/f6/56/1438976969.webp"
            }
        ],
        "advertiser": {
            "type": "professional",
            "name": "Soluciones Tengacasa",
            "commercial_name": "Soluciones Tengacasa",
            "reference": "23771",
            "phone": "+34913559999",
            "logo": "https://st3.idealista.com/dc/c4/06/solucionestengacasa.gif",
            "agency_id": "solucionestengacasa",
            "address": null
        },
        "published_at": null
    }
]
相似属性 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/15077/idealista+api/40037/similar+properties?country=es&property_id=113109809&language=en' --header 'Authorization: Bearer YOUR_API_KEY' 


    

API 访问密钥和身份验证

注册后,每个开发者都会被分配一个个人 API 访问密钥,这是一个唯一的字母和数字组合,用于访问我们的 API 端点。要使用 理想主义者 API 进行身份验证,只需在 Authorization 标头中包含您的 bearer token。

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

无长期承诺。随时升级、降级或取消。 免费试用包括最多 50 个请求。

(年度计费可节省 2 个月 🎉)

起价
$10,000/年


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

概览

西班牙语 意大利语 葡萄牙语 和 法语 房地产:带过滤器的出售或出租物业搜索 财产详情 照片 类似房屋 中介 和 位置查询

理想主义者 API FAQs

每个端点返回与房地产相关的特定数据,包括物业、代理机构和地点。例如,GET代理机构详情端点提供代理机构简介,而GET搜索物业端点列出了待售或出租的物业,包括价格、大小和特点等细节

关键字段因端点而异 对于获取机构属性,字段包括财产ID 标题 价格 尺寸和特点 获取财产详情端点包括字段如价格 描述和地址 提供全面的财产信息

参数因端点而异。对于获取机构属性,您可以按 agency_id、操作(销售/出租)和物业类型进行筛选。获取搜索物业端点允许 location_id、操作和各种过滤器,以根据用户需求自定义结果

响应数据以JSON格式结构化,具有清晰的层级。例如GET物业详情端点返回一个包含物业属性的主对象,而嵌套对象提供详细信息如地址和特征,便于解析

每个端点提供不同的信息 获取代理详细信息提供代理档案 获取物业类型列出物业类别 获取搜索物业返回带有详细属性的列表 这种多样性支持全面的房地产搜索

数据准确性通过Idealista的定期更新和质量检查得以保持 API从经过验证的房源和机构提取数据 确保用户获得可靠和最新的房产和机构信息

典型用例包括搜索购房或租房的物业 比较中介提供的服务 以及分析特定区域的房地产趋势 开发者可以将这些数据集成到房地产列表 市场分析或用户搜索的应用程序中

用户可以通过解析 JSON 响应来利用返回的数据,以提取相关信息进行展示或分析 例如,他们可以按价格或大小筛选属性 在网站上显示代理详情或使用位置信息创建交互式地图

一般常见问题

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