# 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
    }

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 Walmart 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