Idealista Scraper — Spain, Portugal and Italy listings from any search URL

Extract property listings from idealista.com (Spain), idealista.pt (Portugal) and idealista.it (Italy) — the largest real-estate portals in all three countries — from any search URL you paste in. Sale and rent, flats, houses, rooms, offices, garages, land, new developments; every filter and sort order idealista offers. Also scrapes individual property pages.

No proxy configuration, no cookies, no login. Anti-bot handling is built in. Pay only for the listings you get.

What you get

One clean JSON record per property:

• Core: id, url, title, price (EUR), price per m², previous price and price-drop percentage when the price was lowered, site and country
• Property: rooms, size in m², floor (number and original text), elevator, exterior/interior, parking included, listing tags (luxury, exclusive, renovated, new development...)
• Advertiser: private or professional, agency name and agency page URL
• Media: main image, all listing images, image count, whether the listing has a floor plan, 3D tour or video
• Search context: the search URL and result page the listing came from, scrape timestamp

Turn on Fetch full property details and every record additionally gets:

• Full description text
• Location (neighbourhood, city), typology and operation (sale / rent)
• Bathrooms, year built, condition, orientation, heating, equipment — every feature idealista lists, grouped under idealista's own headings (features) and as a flat list (featureList)
• Energy certificate class (A+ … G), consumption and emissions
• Advertiser name, advertiser page, listing reference, last-update text
• All full-size photos (images) and floor plans (floorPlans) separately, with photo labels (living room, kitchen, terrace...)

How to use it

1. Go to idealista.com, idealista.pt or idealista.it and search with any filters you want — operation, type, location, price, size, rooms, features, sort order.
2. Copy the URL of the results page, for example:
   • https://www.idealista.com/venta-viviendas/madrid-madrid/con-precio-hasta_300000,de-dos-dormitorios/
   • https://www.idealista.pt/arrendar-casas/lisboa/com-preco-max_1500/
   • https://www.idealista.it/vendita-case/milano-milano/con-prezzo_400000/
3. Paste one or more URLs into Idealista search URLs, set Max listings per search URL, and run.

To scrape specific properties, paste their URLs (https://www.idealista.com/inmueble/112367425/, https://www.idealista.pt/imovel/35081413/, https://www.idealista.it/immobile/35555810/) into Individual property URLs. These always return full details.

Idealista shows at most 60 result pages (1,800 listings) per search. To collect a large area completely, split it into several searches (by district, price band or property type) and pass all the URLs in one run — duplicates are removed automatically.

Example output

{
  "id": 112367425,
  "url": "https://www.idealista.com/inmueble/112367425/",
  "title": "Piso en Calle de Pelayo, Chueca-Justicia, Madrid",
  "price": 1200000,
  "priceText": "1.200.000€",
  "currency": "EUR",
  "pricePerM2": 10000,
  "previousPrice": null,
  "priceDropPercent": null,
  "rooms": 2,
  "sizeM2": 120,
  "floorText": "3ª planta exterior con ascensor",
  "floor": 3,
  "hasElevator": true,
  "isExterior": true,
  "parkingIncluded": false,
  "tags": ["Lujo"],
  "isProfessional": true,
  "agencyName": "Gilmar Centro",
  "agencyUrl": "https://www.idealista.com/pro/gilmar-centro/",
  "isFeatured": true,
  "hasFloorPlan": true,
  "has3DTour": false,
  "hasVideo": false,
  "imageCount": 32,
  "imageUrl": "https://img4.idealista.com/blur/WEB_DETAIL/0/id.pro.es.image.master/95/1c/93/1470614327.jpg",
  "images": ["..."],
  "location": "Chueca-Justicia, Madrid",
  "typology": "home",
  "operation": "sale",
  "bathrooms": 2,
  "builtYear": 1900,
  "energyClass": "C",
  "energyConsumption": "Consumo: 78 kWh/m² año",
  "energyEmissions": "Emisiones: 20 kg CO2/m² año",
  "description": "GILMAR Consulting Inmobiliario pone a su disposición, ubicado en el emblemático barrio de Justicia...",
  "features": {
    "Características básicas": ["120 m² construidos", "2 habitaciones", "2 baños", "Balcón", "Segunda mano/buen estado", "Armarios empotrados", "Orientación sur, este", "Construido en 1900", "Calefacción individual"],
    "Edificio": ["3ª planta exterior", "Con ascensor"],
    "Equipamiento": ["Aire acondicionado"],
    "Certificado energético": ["Consumo: 78 kWh/m² año", "Emisiones: 20 kg CO2/m² año"]
  },
  "reference": "AG223210",
  "advertiserName": "Gilmar Centro",
  "advertiserType": "professional",
  "updatedText": "Anuncio actualizado el 5 de septiembre",
  "floorPlans": ["https://img4.idealista.com/blur/WEB_DETAIL/0/id.pro.es.image.master/41/09/ba/1470991594.jpg"],
  "site": "idealista.com",
  "country": "ES",
  "searchUrl": "https://www.idealista.com/venta-viviendas/madrid-madrid/",
  "page": 1,
  "scrapedAt": "2026-09-05T17:24:01.789Z"
}

Download the dataset as JSON, CSV, Excel or XML from the run's Output tab, or through the API.

Pricing

Pay per event, no subscription:

• Listing — one property returned from a search (all fields from the results page).
• Detail — extra event per property when Fetch full property details is on, or when you pass individual property URLs.

Nothing is charged for pages that fail, and duplicates within a run are never charged twice. Platform usage (compute, proxy) is included in the price.

Use cases

• Market analysis: price per m² by district, price drops, time on market, new-development pipeline.
• Lead generation: agencies and private advertisers by area, with their listing portfolio.
• Deal alerts: run on a schedule with a filtered search URL and push new listings to Slack, email, Google Sheets or your CRM via Apify integrations.
• Data products: feed valuation models, rental-yield dashboards or investment screeners.

Limitations

• Phone numbers are not extracted (idealista reveals them only after a click that requires a logged-in user).
• Exact GPS coordinates are shown by idealista only on the map, not in the listing page; the location field gives neighbourhood and city.
• A search returns at most 1,800 listings (60 pages). Split large searches with filters.

API example

curl -X POST "https://api.apify.com/v2/acts/amitaviv~idealista-scraper/run-sync-get-dataset-items?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"searchUrls": ["https://www.idealista.com/venta-viviendas/madrid-madrid/"], "maxItemsPerSearch": 60, "fetchDetails": true}'

Node.js, Python and other clients are available in the API tab of the actor.

Issues and requests

If idealista changes its layout or you need extra fields, open an issue on the Issues tab. Bugs are usually fixed within a day.