Idealista Property Listings Scraper | Sale & Rent

Search and export unique Idealista property listings across Spain, Portugal, Italy and France. Every saved listing includes normalized property data plus the public detail and multimedia information available for that listing.

What this Actor does

This Actor searches Idealista by country, location, sale or rent, property category and optional price or bedroom filters. It resolves each location before searching, removes duplicates across locations, and writes one structured Dataset item per unique listing. The public output uses one consistent mode: Full + multimedia.

Each item combines stable identifiers, listing URLs, title, price, location, coordinates, property characteristics, description, energy information, advertiser data when available, and multimedia metadata. Public source payloads are retained under sourceData so an integration can inspect the search, detail and multimedia portions used to build the normalized record.

Use cases

• Build a property inventory for a city, province or complete market.
• Compare sale and rental supply across several locations.
• Enrich a real-estate, market-research or lead-analysis workflow with structured listing data.
• Keep image, video and tour references together with the corresponding property record.

How to use

1. Open the Actor in Apify Console.
2. Select the country, operation and property category, then enter one or more locations.
3. Add optional price or bedroom filters and choose the maximum number of unique listings.
4. Start the run and open the default Dataset or the propertyListings output.

Example input for a small search:

{
  "country": "es",
  "locations": ["Madrid", "Málaga"],
  "operation": "sale",
  "propertyType": "homes",
  "maxItems": 30
}

Input

locations is the only required field. It accepts up to 20 place names and the names are resolved against Idealista's own location suggestions. country accepts es, pt, it or fr. operation accepts sale or rent. propertyType accepts homes, offices, premises, garages, bedrooms, storageRooms, lands, buildings or newDevelopments.

minPrice, maxPrice and bedrooms are optional filters. maxItems controls the complete run and accepts 30–5,000 unique listings. Request pacing and temporary recovery are managed automatically by the Actor.

{
  "country": "es",
  "locations": ["Madrid", "Málaga"],
  "operation": "sale",
  "propertyType": "homes",
  "minPrice": 100000,
  "maxPrice": 300000,
  "bedrooms": 2,
  "maxItems": 30
}

Output

The default Dataset contains one item per unique listing. The propertyListings output opens the Dataset view and summary contains the customer-facing completion status, listing counts, requested locations and enrichment coverage. A run can return fewer items when a location has fewer available listings or a listing cannot provide all optional fields; missing values remain null.

The Full + multimedia mode requests and merges the public detail and dedicated multimedia responses for each delivered listing. multimedia contains media metadata and source URLs when available; it does not package image or video files. sourceData groups the public source payloads under search, detail and multimedia.

The following complete item shows the current Dataset contract. Contact details are shortened in this documentation example.

{
  "propertyCode": 112511261,
  "url": "https://www.idealista.com/inmueble/112511261/",
  "title": "Piso en venta en Calle Monte Miramar, 56",
  "country": "es",
  "operation": "sale",
  "propertyType": "homes",
  "locationId": "0-EU-ES-29-02-001-067-02-002",
  "extendedPropertyType": "flat",
  "homeType": "flat",
  "typology": "flat",
  "price": 850000.0,
  "priceInfo": {"amount": 850000.0, "currencySuffix": "€"},
  "priceByArea": 8416.0,
  "priceDropValue": null,
  "priceDropPercentage": null,
  "priceDropInfo": null,
  "address": "Piso en Calle Monte Miramar, 56, Limonar, Málaga",
  "municipality": "Málaga",
  "province": "Comarca de Málaga, Málaga",
  "district": "Distrito Este",
  "neighborhood": "Barrio Limonar",
  "latitude": 36.7284362,
  "longitude": -4.3959891,
  "size": 101.0,
  "usableArea": null,
  "rooms": 2.0,
  "bedrooms": null,
  "bathrooms": 2.0,
  "floor": "1",
  "exterior": true,
  "hasLift": true,
  "hasParking": true,
  "hasVideo": true,
  "has360": false,
  "has3DTour": false,
  "newDevelopment": true,
  "newProperty": false,
  "status": "active",
  "description": "Public property description returned by Idealista.",
  "externalReference": "Primera 2",
  "thumbnail": "https://img4.idealista.com/example-thumbnail.jpg",
  "numPhotos": 13.0,
  "features": {
    "hasSwimmingPool": false,
    "hasTerrace": true,
    "hasAirConditioning": true,
    "hasBoxRoom": true,
    "hasGarden": false
  },
  "labels": [],
  "contactInfo": {
    "commercialName": "Advertiser name when supplied",
    "userType": "professional"
  },
  "energyCertification": {
    "title": "Certificado energético del proyecto",
    "energyConsumption": {"prefix": "Consumo:", "type": "a"},
    "emissions": {"prefix": "Emisiones:", "type": "a"}
  },
  "multimedia": {
    "images": [{"url": "https://img4.idealista.com/example-image.jpg", "tag": "livingRoom"}],
    "videos": [],
    "hasMultimediasMadeByIdealista": false
  },
  "detailStatus": "fetched",
  "sourceData": {
    "search": {"propertyCode": 112511261},
    "detail": {"detailWebLink": "https://www.idealista.com/inmueble/112511261/"},
    "multimedia": {"images": [{"url": "https://img4.idealista.com/example-image.jpg"}], "videos": []}
  },
  "modificationDate": "Anuncio actualizado recientemente",
  "searchLocation": "Málaga, Málaga",
  "scrapedAt": "2026-09-29T09:09:10Z"
}

Pricing

The Actor uses one result event. One event represents one unique listing saved to the default Dataset. Failed, duplicate and undelivered listings are not charged. Apify resolves the applicable customer tier from the configured tiered event prices.

Apify tier	Price per listing	Equivalent per 1,000 listings
FREE	$0.001500	$1.50
BRONZE	$0.001350	$1.35
SILVER	$0.001200	$1.20
GOLD	$0.001125	$1.125
PLATINUM	$0.001125	$1.125
DIAMOND	$0.001125	$1.125

Related Actors

Actor	Best for
Fotocasa Spain Property Listings Scraper	Comparing Spanish property supply from Fotocasa.
Realtor.com US Property Listings Scraper	Collecting comparable property listings in the United States.

Limits and data quality

Coverage is limited to the four supported markets and the public listings available when the run starts. A location must resolve to an Idealista suggestion. Advertiser fields, coordinates, descriptions, media, price-change information and energy data vary by listing. The Actor preserves the available values and returns null when a field is absent.

Results are deduplicated across all requested locations and the maxItems limit applies to the complete run. Pagination stops when the source is exhausted or the requested unique count is reached. The run summary distinguishes completed, partial and failed work, while detailStatus identifies whether the public detail data was fetched, unavailable or not present.

Frequently asked questions

Can I search several cities in one run?

Yes. Enter up to 20 locations. The maximum number of unique listings applies to the complete run, not separately to each location.

What does Full + multimedia include?

It includes the normalized listing, public detail fields, advertiser data when available, multimedia metadata and the corresponding public source payload groups. Image and video URLs are returned as references; media files are not downloaded into the Dataset.

Are photos, videos or tours guaranteed for every listing?

No. Their presence depends on the individual public listing. A listing without a particular media type is still returned with the relevant field empty or null.

What happens when optional listing data is missing?

The listing remains usable. Missing optional values are represented as null, and the summary records the final run status and enrichment counts.

Responsible use

You are responsible for using the results lawfully and for complying with applicable terms of service, privacy rules, intellectual-property rights and other regulations. Use the data only for purposes permitted in your jurisdiction and respect any restrictions that apply to the source or the people represented in the data.

Support

For help, open an issue in the Actor's Issues tab and include a reproducible input, the run ID and the relevant summary message. Do not include private credentials or sensitive personal data in the issue.

Public integration examples on GitHub