Idealista Property Scraper

Watching the Spanish, Italian, or Portuguese housing market on Idealista usually means clicking through page after page and copying details by hand: price, size, bedrooms, the agency behind each listing. This scraper does the clicking for you. Paste an Idealista search URL and every listing comes back as a clean row, with price, area, location, and agency already split into fields and ready for a spreadsheet or a model. It runs fast, costs little, needs no code, and you only pay for what you scrape.

What you get

Each listing comes back as one row with three kinds of data:

• Identity and link — listingId, listingTitle, listingUrl, searchPageUrl, resultsPage
• Price and size — priceValue, currencyCode, squareMeterPrice, bedroomCount, floorAreaSqm, featureChips
• Listing and agency — summary, labelTags, imageLinks, coverImage, agentName, agentUrl, isPromoted, collectedAt

Quick start

1. Open Idealista, apply your filters (area, price, buy or rent), and copy the URL from the address bar.
2. Hit Try for free and paste that URL into Search URLs.
3. Set a Results limit to control how many listings you pull per URL.
4. Press Start, then export the results as JSON, CSV, Excel, or XML.

Use cases

• Price tracking — follow asking prices across a city or district and catch reductions early
• Area comparison — line up price per m², bedroom counts, and sizes between neighbourhoods
• Investment research — assemble a dataset of for-sale or rental stock to score against your own criteria
• Agency analysis — see which agencies list what, where, and at what price
• Market dashboards — pipe live Idealista data into your own sheet, BI tool, or app

Input

Field	Type	Required	Description
searchUrls	array of strings	Yes	Idealista search or listing URLs to scrape; each one runs on its own with full pagination. Works on the Spain, Italy, and Portugal editions and on buy, rent, or new-build searches. Prefilled with a Valencia for-sale search.
resultsLimit	integer	No	How many listings to gather from each URL. Default 50.
timeoutSeconds	integer	No	Seconds to wait on each request before giving up. Default 45.

Example input

{
    "searchUrls": [
        "https://www.idealista.com/venta-viviendas/valencia-valencia/"
    ],
    "resultsLimit": 50,
    "timeoutSeconds": 45
}

Output

Every listing on the search results becomes one row, paginated automatically up to your limit. Fields that Idealista does not show for a given property come back empty rather than guessed.

Example output

{
    "listingId": "107654321",
    "listingTitle": "Piso en venta en calle de Colón, Eixample",
    "listingUrl": "https://www.idealista.com/inmueble/107654321/",
    "priceValue": 385000,
    "currencyCode": "EUR",
    "squareMeterPrice": 4280,
    "bedroomCount": 3,
    "floorAreaSqm": 90.0,
    "featureChips": ["3 hab.", "90 m²", "Garaje incluido"],
    "summary": "Luminoso piso reformado en pleno Eixample, a dos minutos del mercado de Colón.",
    "labelTags": ["Reformado", "Con ascensor"],
    "imageLinks": [
        "https://img4.idealista.com/blur/WEB_LISTING/0/id.pro.es.image/example-1.jpg",
        "https://img4.idealista.com/blur/WEB_LISTING/0/id.pro.es.image/example-2.jpg"
    ],
    "coverImage": "https://img4.idealista.com/blur/WEB_LISTING/0/id.pro.es.image/example-1.jpg",
    "agentName": "Inmobiliaria Mediterráneo",
    "agentUrl": "https://www.idealista.com/pro/inmobiliaria-mediterraneo/",
    "isPromoted": false,
    "searchPageUrl": "https://www.idealista.com/venta-viviendas/valencia-valencia/",
    "resultsPage": 1,
    "collectedAt": "2026-06-29T12:00:00.000000+00:00"
}

Output fields

Field	Type	Description
listingId	string	Idealista's own identifier for the listing
listingTitle	string	Property headline as printed on the result card
listingUrl	string	Direct link to the property's detail page
priceValue	integer	Asking price in euros
currencyCode	string	Three-letter currency code, always EUR
squareMeterPrice	integer	Asking price for each square metre, in euros
bedroomCount	integer	How many bedrooms the property offers
floorAreaSqm	number	Built area of the property in m²
featureChips	array	Quick-detail chips on the card (garage, bedroom, size labels)
summary	string	Short description snippet from the result card
labelTags	array	Keyword badges attached to the listing
imageLinks	array	Every photo URL found on the listing card
coverImage	string	First photo URL, handy as a thumbnail
agentName	string	Real estate agency behind the listing, when shown
agentUrl	string	Link to the agency's profile on Idealista
isPromoted	boolean	True when the listing ran as a featured result
searchPageUrl	string	The results page this listing was pulled from
resultsPage	integer	Which results page number the listing showed up on
collectedAt	string	ISO 8601 timestamp of when the row was captured

Tips for best results

• Filter on Idealista first. The tighter your search URL (area, price band, property type), the cleaner and more relevant your dataset.
• Use resultsLimit for test runs. Start with 50 to check the output fits your pipeline, then raise it for the full pull.
• Buy and rent both work. A venta-viviendas URL returns for-sale stock and an alquiler-viviendas URL returns rentals; the listing fields tell them apart.
• Some fields are sparse on certain cards. A listing without an agency shows an empty agentName, and not every card carries squareMeterPrice; those rows still bring back everything else.
• Raise timeoutSeconds if you see timeouts when pulling large result sets.

How can I use Idealista property data?

How can I use the Idealista Property Scraper to track Spanish house prices? Paste an Idealista search URL for your target area and run it on a schedule. Each row carries priceValue, squareMeterPrice, listingTitle, and collectedAt, so you can chart asking prices over time and flag the drops as they happen.

How can I compare neighbourhoods on Idealista by price per m²? Pull listings for several areas and read squareMeterPrice straight from each row, or divide priceValue by floorAreaSqm yourself. With bedroomCount and featureChips alongside, you get a clean side-by-side look at where the value sits.

How can I build an Iberian real estate dataset for investment research? Feed in one or more search URLs, set resultsLimit to the volume you need, and export to CSV or Excel. The result is a structured property database — price, size, location, agency — that you can score against your own buy criteria.

Is it legal to scrape data?

Our actors are ethical and do not extract any private user data, such as email addresses or private contact information. They only extract what the user has chosen to share publicly. We therefore believe that our actors, when used for ethical purposes by Apify users, are safe.

However, you should be aware that your results could contain personal data. Personal data is protected by the 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.

You can also read Apify's blog post on the legality of web scraping.

Support

Questions, feature requests, or a field you'd like added? Reach out at data.apify@proton.me and we'll get back to you.