Idealista Scraper - Real Estate Data for Spain, Italy, Portugal

🤖 What does Idealista-Scraper do?

Idealista-Scraper enables you to easily get data from idealista.com for a very low price.

It can scrape:

• 🏘️ Properties for sale in Spain, Italy, and Portugal
• 🔑 Properties for rent in Spain, Italy, and Portugal

💡 Why scrape idealista.com?

idealista.com has thousands of properties listed and is a great source of data for Real Estate professionals, investors, and anyone looking to buy or rent a property. With Idealista-Scraper, you can get the data you need to make informed decisions about your next property purchase or rental.

Here are just some of the ways you could use that data:

• 📈 Analyze market trends and property price fluctuations in specific areas
• 👀 Monitor competitive pricing for real estate agencies and investors
• 🎯 Generate leads for real estate businesses
• 📊 Research rental yields and investment opportunities in different neighborhoods

🚀 How to scrape idealista.com

It's easy to scrape idealista.com with Idealista-Scraper. Just follow these few steps and you'll get your data in minutes:

1. Click Try for free
2. Enter the operation, property type, country, and location
3. (Optional) Set filters like price, size, bedrooms, etc.
4. Click Run
5. When the run finishes, preview or download your data from the Dataset tab
6. Click All fields to view all available data for each property and choose json or csv format.

⚠️ Important Warnings

• Max items > 2500: If maxItems is greater than 2500, the location will be automatically split into sub-locations. This affects ordering (results are grouped by sub-locations), so you might not get a strict global sort.
• Fetch details: Enabling fetchDetails adds 1 extra request per property and is ~50× slower overall. This feature is currently in beta, use it with caution.

💳 How much will it cost to scrape idealista.com?

Apify provides you with $5 free usage credits every month on the Apify Free plan. You can try and test Idealista-Scraper for free with the Free plan for a limited time.

However, if you need to get more data regularly from idealista.com, you should get an Apify subscription. We recommend our $49/month Personal plan - this plan covers the costs of Idealista-Scraper and numerous executions.

📝 Input Parameters

You can provide either a city name or an Idealista Location ID for location. Find the Location ID with the Idealista Location Search Tool.

Required

Parameter	Options / Example	Description
operation	sale | rent	Listing operation
propertyType	homes, newDevelopments, offices, premises, garages, lands, storageRooms, buildings, bedrooms	Type of property
country	es | pt | it	Country
location	"Madrid" or "0-EU-ES-28-07-001-079"	City name or Idealista Location ID

Core options

Parameter	Type / Options	Description
maxItems	Integer (default 50, 0 = unlimited)	Recommended ≤ 2500. If > 2500, the actor splits the location into sub-locations and ordering is grouped.
sortBy	relevance, closest, lowestPrice, highestPrice, mostRecent, leastRecent, highestPriceReduction, lowestPriceM2, highestPriceM2, biggest, smallest, highestFloors, lowestFloors	Sorting method for results
fetchDetails	Boolean (default false)	Fetch a detailed page per property → adds _details (beta). Much slower & costlier.
minPrice	String (default "0") or preset steps: "50000", "75000", "100000", "125000", "150000", "175000"	Minimum price ("0" = any)
maxPrice	String (default "0") or preset steps up to "4000000"	Maximum price ("0" = any)
minSize	String (default "0") or preset steps (m²): "60", "80", "100", …, "300"	Minimum size in m² ("0" = any)
maxSize	String (default "0") or preset steps (m²): "60", "80", "100", …, "300"	Maximum size in m² ("0" = any)
publicationDate	"" (any), Y (last 48h), W (last week), M (last month)	Filter by publication date

Advanced filters

• bedrooms (array): ["studio","1","2","3","4"] (leave empty for any)
• bathrooms (array): ["1","2","3"] (leave empty for any)
• homeType (array): ["flat","penthouse","duplex","detachedHouse","semiDetachedHouse","terracedHouse","countryHouse","apartment","villa","loft"]
• condition (array): ["newDevelopment","good","renew"]
• propertyStatus (array): ["bareOwnership","tenanted","illegallyOccupied","free"]
• floor (array): ["topFloor","intermediateFloor","groundFloor"]

Amenities & features (booleans)

airConditioning, fittedWardrobes, lift, balcony, terrace, exterior, garage, garden, swimmingPool, storageRoom, accessible, seaViews, luxury, plan (floor plan), virtualTour.

Proxy

Use Apify's proxy editor via proxyConfiguration:

• useApifyProxy: true
• (Recommended) apifyProxyGroups: ["RESIDENTIAL"]

Residential proxies help prevent detection and IP blocking.

Example input

{
  "maxItems": 100,
  "operation": "sale",
  "propertyType": "homes",
  "country": "es",
  "location": "0-EU-ES-28-07-001-079",
  "sortBy": "mostRecent",
  "fetchDetails": false,
  "minPrice": 200000,
  "maxPrice": 500000,
  "minSize": 80,
  "maxSize": 120,
  "publicationDate": "W",
  "bedrooms": ["2", "3"],
  "bathrooms": ["2"],
  "homeType": ["flat", "penthouse"],
  "condition": ["newDevelopment", "good"],
  "propertyStatus": [],
  "floor": ["intermediateFloor"],
  "airConditioning": true,
  "fittedWardrobes": true,
  "lift": true,
  "balcony": false,
  "terrace": false,
  "exterior": true,
  "garage": true,
  "garden": false,
  "swimmingPool": false,
  "storageRoom": true,
  "accessible": false,
  "seaViews": false,
  "luxury": false,
  "plan": false,
  "virtualTour": false,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"]
  }
}

📊 Results

You'll get a list of property objects similar to Idealista's listing data. If fetchDetails: true, each item includes an extra field: _details with detailed page data (beta).

[
  {
    "propertyCode": "106316721",
    "thumbnail": "https://img4.idealista.com/blur/WEB_LISTING-M/0/id.pro.es.image.master/46/12/06/1279185415.webp",
    "externalReference": "21",
    "numPhotos": 23,
    "floor": "3",
    "price": 105000,
    "priceInfo": {
      "price": {
        "amount": 105000
      }
    },
    "propertyType": "flat",
    "operation": "sale",
    "size": 78,
    "exterior": true,
    "rooms": 3,
    "bathrooms": 1,
    "address": "plaza Labradores, 9 --11",
    "province": "La Rioja",
    "municipality": "Ezcaray",
    "district": "",
    "country": "es",
    "locationId": "0-EU-ES-26-02-002-061",
    "latitude": 42.3203813,
    "longitude": -3.0147614,
    "showAddress": true,
    "url": "https://www.idealista.com/inmueble/106316721/",
    "description": "Ezcaray ofrece algunas de las mejores vistas a las montañas en La Rioja, convirtiéndolo en un destino ideal para los amantes de la naturaleza y la aventura.     Desde esta vivienda lo puedes comprobar! Gracias a su altura y orientación vas a poder disfrutar de las mejores vistas de Ezcaray.     Tiene tres habitaciones bien orientadas, una de ellas con mirador y balcón orientados al sur, salón, cocina amplia y baño completo.     Calefacción con calefactor de leña e instalación de radiadores.     Merece la pena llamar y concertar una visita!",
    "hasVideo": true,
    "status": "renew",
    "newDevelopment": false,
    "favourite": false,
    "newProperty": false,
    "multimedia": {
      "images": [
        {
          "url": "https://img4.idealista.com/blur/WEB_LISTING-M/0/id.pro.es.image.master/46/12/06/1279185415.webp",
          "tag": "views"
        },
        {
          "url": "https://img4.idealista.com/blur/WEB_LISTING-M/0/id.pro.es.image.master/56/0f/43/1279185423.webp",
          "tag": "kitchen"
        },
        {
          "url": "https://img4.idealista.com/blur/WEB_LISTING-M/0/id.pro.es.image.master/1c/91/45/1279185430.webp",
          "tag": "livingRoom"
        },
        {
          "url": "https://img4.idealista.com/blur/WEB_LISTING-M/0/id.pro.es.image.master/4d/03/c6/1279185433.webp",
          "tag": "bedroom"
        }
      ],
      "virtual3DTours": []
    },
    "contactInfo": {
      "commercialName": "INMOBILIARIA  LA ZALAYA ",
      "contactName": "INMOBILIARIA  LA ZALAYA ",
      "userType": "professional",
      "contactMethod": "all",
      "phone1": {
        "phoneNumber": "941776986",
        "formattedPhone": "941 77 69 86",
        "prefix": "34",
        "phoneNumberForMobileDialing": "+34941776986",
        "nationalNumber": true
      },
      "agencyLogo": "https://st3.idealista.com/9e/99/38/inmobiliaria-la-zalaya.gif",
      "micrositeShortName": "inmobiliaria-la-zalaya",
      "totalAds": 0
    },
    "hasLift": false,
    "parkingSpace": {
      "hasParkingSpace": false,
      "isParkingSpaceIncludedInPrice": false
    },
    "priceByArea": 1346,
    "features": {
      "hasSwimmingPool": false,
      "hasTerrace": false,
      "hasAirConditioning": false,
      "hasBoxRoom": false,
      "hasGarden": false
    },
    "detailedType": {
      "typology": "flat"
    },
    "suggestedTexts": {
      "subtitle": "",
      "title": "Piso en plaza Labradores, 9 --11"
    },
    "hasPlan": false,
    "has3DTour": false,
    "has360": false,
    "hasStaging": false,
    "isOnlineBookingActive": false,
    "ribbons": [],
    "topNewDevelopment": false,
    "topPlus": false,
    "preferenceHighlight": false,
    "urgentVisualHighlight": false,
    "visualHighlight": false,
    "topHighlight": false,
    "_details": {
      /* present only when fetchDetails=true (beta) */
    }
  }
  ...
]

🌍 Proxy

Idealista-Scraper uses Apify Residential Proxies to prevent detection and IP blocking. Apify Proxy is a rotating proxy service that provides a pool of IP addresses. This way, Idealista-Scraper can make a large number of requests to idealista.com without being blocked.

⚖️ Is it legal to scrape idealista.com?

Note that personal data is protected by GDPR in the European Union and by other regulations around the world. You should not scrape personal data unless you have a legitimate reason to do so. If you're unsure whether your reason is legitimate, consult your lawyers. We also recommend that you read our blog post: is web scraping legal?