Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.zenrows.com/llms.txt

Use this file to discover all available pages before exploring further.

The Idealista Property Data API provides tailored endpoints to extract comprehensive property details directly from Idealista. With this powerful tool, you can seamlessly integrate real estate data into your applications, enabling in-depth market analysis, reporting, or decision-making. Easily extract detailed property information from Idealista. This endpoint provides everything you need to analyze or present Idealista property data effectively, such as:
  • Detailed Property Information: Extract property specifics, including address, bedrooms, bathrooms, pricing, and more.
  • Agent and Agency Details: Gather information about agencies or agents associated with listed properties, including agency name, logo, and contact information.
  • Geolocation Data: Retrieve latitude and longitude for properties to integrate with mapping tools.
  • Images and Features: Access property images and a list of unique features to enhance your data presentations.
  • Dynamic Status Updates: Ensure up-to-date information with the latest property status, modification dates, pricing, and deactivate dates when applicable.

​
Supported Query Parameters

PARAMETERTYPEDEFAULTDESCRIPTION
propertyId requiredstringThe Unique ID of the Idealista property. Example: 1234567890.
urlstringThe URL from which the desired property data will be retrieved. Example: https://www.idealista.com/inmueble/1234567890.
tldstring.comThe top-level domain of the Idealista website. Supported examples: .com, .it .pt
langstringLanguage of the target countryThe language to display results. Supported values: "en", "es", "ca", "it", "pt", "fr", "de", "da", "fi", "nb", "nl", "pl", "ro", "ru", "sv", "el", "zh", "uk". The default is the language of the target country (e.g., "es" for .com, "it" for .it, and "pt" for .pt). Example: lang=en.

​
How to Setup

Fetch details for a property using its PropertyID. 
https://realestate.api.zenrows.com/v1/targets/idealista/properties/{propertyId}?apikey=YOUR_ZENROWS_API_KEY

​
Example

cURL
curl "https://realestate.api.zenrows.com/v1/targets/idealista/properties/{propertyId}?apikey=YOUR_ZENROWS_API_KEY"
Replace {propertyId} with the actual property ID code.
# pip install requests
import requests

property_id = "1234567890"  # Example property ID
api_endpoint = f"https://realestate.api.zenrows.com/v1/targets/idealista/properties/{property_id}"
params = {
    "apikey": "YOUR_ZENROWS_API_KEY",
}
response = requests.get(api_endpoint, params=params)
print(response.text)

{
    "property_id": 1234567890,
    "address": "Calle de Alcalá, Madrid",
    "latitude": 40.423,
    "longitude": -3.683,
    "location_name": "Madrid",
    "location_hierarchy": ["Madrid", "Centro", "Sol"],
    "country": "es",
    "agency_name": "Best Properties Madrid",
    "agency_phone": "+34 912 345 678",
    "agency_logo": "https://example.com/logo.png",
    "bathroom_count": 2,
    "lot_size": 120,
    "operation": "sale",
    "price_currency_symbol": "€",
    "property_condition": "good",
    "property_description": "Bright and spacious apartment located in the heart of Madrid, fully renovated with modern finishes.",
    "property_equipment": [
        "Air Conditioning",
        "Heating",
        "Elevator",
        "Furnished Kitchen"
    ],
    "property_features": [
        "Terrace",
        "Exterior",
        "Balcony",
        "Built-in wardrobes"
    ],
    "property_images": [
        "https://example.com/image1.jpg",
        "https://example.com/image2.jpg",
        "https://example.com/image3.jpg"
    ],
    "property_image_tags": [
        "facade",
        "living room",
        "kitchen"
    ],
    "energy_certificate": "D",
    "modified_at": 1714078923,
    "last_deactivated_at": null
    }

​
Response Structure

Depending on the property status (active or inactive), the returned fields may vary:
  1. For Active Listings:
    Full property details are returned, including address, price, features, images, geolocation, agency details, and more.
  2. For Inactive Listings:
    Only a subset of fields will be present:
    FIELDDESCRIPTION
    property_idUnique identifier of the property.
    last_deactivated_atTimestamp indicating when the listing was deactivated.
    operationOperation type (e.g., sale, rent).
    agency_nameName of the agency if the listing was published by one.
    agency_logoLogo URL of the agency if available.

​
Troubleshooting and FAQs

You can retrieve the propertyId from the URL of the property listing on Idealista. For example, the URL https://www.idealista.com/inmueble/1234567890 contains the propertyId as 1234567890.
If a property is inactive, the last_deactivated_at field will be populated with a Unix timestamp. Some fields like images or descriptions might also be missing when a property is no longer active.
Both modified_at and last_deactivated_at use Unix timestamps, representing the number of seconds since January 1, 1970 (UTC).
property_features lists characteristics of the property such as “Terrace” or “Balcony”, while property_equipment lists available equipment and amenities like “Air Conditioning” or “Elevator”.
property_images provides direct URLs to the property’s photos. property_image_tags gives context to each image, indicating what the photo shows (e.g., “facade”, “kitchen”).
Yes, if the property does not have an energy certificate available, the energy_certificate field may be null or missing.
The operation field indicates if the property is listed for “sale” or “rent”.
The address, latitude, longitude, location_name, location_hierarchy, and country fields together provide complete information about the property’s location.
If a property was updated recently, you will get the latest data, and the modified_at timestamp will reflect the most recent modification time.
The agency_logo field contains a direct URL to the logo image of the real estate agency managing the property.