Using the Idealista Property Data API

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

​

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 "https://realestate.api.zenrows.com/v1/targets/idealista/properties/{propertyId}?apikey=YOUR_ZENROWS_API_KEY"

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

   FIELD	DESCRIPTION
   property_id	Unique identifier of the property.
   last_deactivated_at	Timestamp indicating when the listing was deactivated.
   operation	Operation type (e.g., sale, rent).
   agency_name	Name of the agency if the listing was published by one.
   agency_logo	Logo URL of the agency if available.

​

Troubleshooting and FAQs