Idealista Scraper - Spain, Italy, Portugal Listings

🏠 What is Idealista Scraper?

Idealista Scraper extracts property listings from idealista in Spain, Italy and Portugal: price, size, bedrooms, GPS, photos, full description, the advertiser's name and phone number, price drops and, on request, the full listing page, the agency's profile (year on idealista, listings, office, website) and its e-mail. Homes for sale or rent, new builds, rooms to share, holiday rentals, offices, shops, garages, land and buildings.

Type a city (Madrid, Milano, Lisboa), pick sale or rent, click Start, and download the listings in JSON, CSV or Excel. No login, nothing to set up, and it is fast: about 1,000 listings a minute.

📋 What data can you extract from idealista?

One item per listing, 105 fields:

Category	What you get
🏷️ Listing	title, link, idealista code, sale or rent, property type — Piso en Calle de López de Hoyos, Castellana, Madrid
💰 Price	price, price per m², previous price, drop in € and %, date of the drop — 2,695,000 EUR, -2 %
📐 Property	size, bedrooms, bathrooms, floor, condition, lift, parking, terrace, pool, air conditioning, garden
📍 Location	address, neighbourhood, district, city, province, GPS coordinates
📷 Photos and media	photo links with the room of each photo, videos, 3D tours, floor plan
📞 Advertiser	agency or private seller, contact name, phone number (+34919381590), agency page and logo
🏷️ Badges	idealista labels (luxury, bright…), new build, new listing, paid highlights
📄 Listing page (option)	every photo, energy certificate, community costs, built / usable area, year built, heating, orientation, last update, description in every language
🏢 Agency (option)	agency profile: year it joined idealista, number of listings, description, cover photo, video, office address, GPS and phone, website — and the e-mail found on the agency website

Every field, with an example, is listed in the Output section below.

Fields marked (listing page) are filled when Open each listing page (includeDetails) is on, those marked (agency page) when Add the agency profile (includeAgencyProfile) is on. Everything else — phone number included — comes with every listing.

✅ Why use Idealista Scraper?

• 🚀 Fast: about 1,000 listings a minute; with Add the agency profile and Find agency e-mails, about 200-400 a minute (with Open each listing page: about 40 listings a minute).
• 📞 The advertiser's phone number comes with the search results, at no extra cost (no listing page to open).
• 🧩 Past the 2,500-listing limit of a search: a bigger search is split by price ranges automatically, so a whole city can be read.
• 🎯 60+ filters: price, size, bedrooms, bathrooms, condition, floor, energy rating, lift, parking, terrace, pool, auctions, bank properties, tenanted or free, furnished, and every filter of rooms to share (gender, couples, pets, smokers…).
• 🌍 Spain, Italy and Portugal — search by city, keyword, agency, point and radius, map area, or listing codes.
• 🔔 Monitoring built in: tick Only new listings, schedule the Actor, and each run returns (and charges) only what it has never delivered before. Price drops only returns the listings whose price went down.
• 🔌 API, scheduling, integrations (Make, Zapier, n8n, Google Sheets…) and JSON/CSV/Excel export via the Apify platform.

🚀 How to scrape idealista

1. Create a free Apify account.
2. Open Idealista Scraper, choose the Country, Operation (sale or rent) and Property type, and type a Location (e.g. Madrid).
3. Or paste idealista search, listing or agency URLs into Start URLs, listing codes into Listing IDs, or agency names into Agencies.
4. Set Max listings (100 by default, 0 = no limit) — and Max listings per search when you run several searches — then click Start.
5. Download the dataset in JSON, CSV, Excel or via API.

💰 How much does it cost to scrape idealista?

This Actor uses pay per event pricing: $0.25 per 1,000 listings, phone numbers included — plus $0.001 per run start. Options are charged only when you tick them: $0.25 per 1,000 listings with Open each listing page, $0.10 per 1,000 listings that get their agency's profile (Add the agency profile; private sellers have none, so are not charged), and $0.50 per 1,000 listings whose agency e-mail is found (Find agency e-mails). Filters that idealista does not offer are applied by the Actor on every listing it reads: a listing you keep costs its normal price, a listing a filter drops costs $0.29 per 1,000 listings dropped by Private advertisers only, With phone only, Price drops only or Exclude keywords, and $0.29 per 1,000 listing pages dropped by Updated after / before — both $0.28 on Bronze, $0.27 on Silver and $0.26 on Gold. Example: 20,000 listings of a city ≈ $5; a daily monitor of 300 new listings ≈ $0.08 a day. Platform usage (compute, proxy) is included in the price.

⚙️ Input

{
    "country": "es",
    "operation": "sale",
    "propertyType": "homes",
    "location": "Madrid",
    "maxItems": 200
}

Several cities, a cap per city, filters, only the listings not delivered before:

{
    "country": "it",
    "operation": "rent",
    "propertyType": "homes",
    "locations": ["Milano", "Roma"],
    "maxItemsPerQuery": 500,
    "maxPrice": 1500,
    "bedrooms": ["2", "3"],
    "features": ["elevator", "terrace"],
    "onlyNew": true,
    "stateKey": "rent-milano-roma"
}

Or with your own URLs and codes:

{
    "startUrls": [
        { "url": "https://www.idealista.com/venta-viviendas/madrid/chamberi/" },
        { "url": "https://www.idealista.com/inmueble/112272495/" }
    ],
    "listingIds": ["36890709"],
    "includeDetails": true
}

Field	Notes
country	Spain (es), Italy (it) or Portugal (pt).
operation	sale or rent.
propertyType	homes, newDevelopments, bedrooms (rooms to share, rent only), vacationRentals (rent only), offices, premises, transfers (sale only), garages, storageRooms, lands, buildings.
location, locations	City, district, province or neighbourhood as typed on idealista, or an idealista location ID; the place found is written in the log.
query, searchQueries	Keywords searched in the listings (e.g. ático terraza), inside each location, or in the whole country without one.
startUrls	idealista search URLs (country, operation, type and location — or map area — are kept; set the filters with the fields below), listing URLs or agency URLs.
listingIds	idealista listing codes of the chosen country, fetched directly.
agencies	Every listing of these agencies: the name in their idealista page URL (engel-volkers) or the whole URL.
latitude, longitude, radiusKm	Search around a point, radius from 0.1 to 50 km.
polygon	Area drawn on the idealista map: the shape value of the map URL, or latitude,longitude points separated by semicolons.
maxItems	Stop after this many listings for the whole run (0 = unlimited).
maxItemsPerQuery	Cap for EACH search (location × keyword, agency, URL…). 0 = no per-search cap.
splitLargeSearches	Split a search of more than 2,500 listings by price ranges to reach every listing (on by default).
sortBy	relevance, newest, lastUpdated, priceLow, priceHigh, priceDrops, pricePerM2Low, pricePerM2High, sizeLarge, sizeSmall.
includeDetails	Open each listing page: every photo, energy certificate, community costs, areas, year built, heating, orientation, agency address and website, last update.
enrichEmails	Read the agency's e-mail on its own website (needs includeAgencyProfile — fast, no listing page opened — or includeDetails).
includeAgencyProfile	Add the agency's idealista profile to each of its listings: year on idealista, listings count, description, cover photo, video, office address, GPS and phone, website. One request per agency, not per listing.
language	Language of the descriptions and labels (idealista's translation when the advertiser did not write it).
minPrice, maxPrice, minSize, maxSize	Price in euros (monthly rent for rentals), built area in m².
bedrooms, bathrooms, condition, homeTypes, floors, energyRating	Any of the chosen values; 4 bedrooms and 3 bathrooms mean "or more".
publishedSince	idealista's own date filter: lastDay, last2Days, lastWeek, lastMonth. idealista offers 48 hours on sales and 24 hours on rentals: lastDay on a sale searches 48 hours, last2Days on a rental searches the last week.
features	Keep only the listings with ALL of these: elevator, airConditioning, parking, garden, swimmingPool, terrace, balcony, storeRoom, builtinWardrobes, exterior, accessible, luxury, seaViews, virtualTour, hasPlan, exteriorDomesticSpace.
auction	excludeAuctions or onlyAuctions (sale).
occupationStatus	free, tenanted, bareOwnership, illegallyOccupied (sale).
bankOffer	Only the properties sold by banks.
furnished	Rent: furnished or furnishedKitchen.
rentalTypes, petsAllowed	Rent: longTerm and / or seasonal; pets accepted.
roomGender	Rooms to share: female or male.
roomOccupation	students or workers.
roomBedType, roomFlatmates, roomRules, roomAvailableFrom, roomAvailableTo	Bed, flatmates, house rules, move-in and move-out dates of a room to share.
postedAfter, postedBefore	Last-update date range read on the listing page (needs includeDetails): 2026-09-01, or a period before now (7 days, 2 weeks, 1 month).
excludeKeywords	Drop the listings whose title or description contains one of these words (case and accents ignored).
privateSellersOnly, requirePhone	Drop the listings of agencies and developers; drop the listings without a phone number.
onlyPriceDrops, minPriceDropPercent	Only the listings whose price went down, and by at least this percentage.
onlyNew, stateKey, resetState	Monitoring: only the listings never delivered under this memory key; resetState forgets the memory.
Advanced	proxyConfiguration (Apify proxy by default, included in the price; the residential proxy is not available), maxConcurrency, maxRequestRetries, debugLog.

📦 Output

A listing of a search (shortened: 105 fields in all, the ones of the listing page are null here):

{
    "id": "112272495",
    "url": "https://www.idealista.com/inmueble/112272495/",
    "title": "Piso en Calle de López de Hoyos, Castellana, Madrid",
    "country": "es",
    "operation": "sale",
    "propertyType": "homes",
    "typology": "flat",
    "price": 2695000,
    "currency": "EUR",
    "pricePerM2": 9489,
    "previousPrice": 2750000,
    "priceDropPercent": 2,
    "size": 284,
    "rooms": 3,
    "bathrooms": 4,
    "floor": "2",
    "condition": "good",
    "hasLift": true,
    "labels": ["Lujo"],
    "address": "Piso en Calle de López de Hoyos, Castellana, Madrid",
    "neighborhood": "Castellana",
    "municipality": "Madrid",
    "latitude": 40.4379032,
    "longitude": -3.6883,
    "images": ["https://img4.idealista.com/s/v1/yLueJcFa…?Expires=1790292734&Signature=…&Key-Pair-Id=K20EOYVFELHOX5"],
    "imageTags": ["livingRoom"],
    "videos": ["https://st3v.idealista.com/fd/15/66/1470511706.mp4"],
    "virtualTours": ["https://my.matterport.com/show/?m=qQ4pCJDD6FA&lang=es"],
    "advertiserName": "Gilmar Barrio de Salamanca",
    "advertiserType": "professional",
    "phone": "+34919381590",
    "agencySlug": "gilmarsalamanca",
    "features": [],
    "descriptionLanguages": [],
    "search": "es · sale · homes · Madrid",
    "scrapedAt": "2026-09-24T08:00:00.000Z"
}

You can download the dataset in various formats such as JSON, HTML, CSV or Excel.

All 105 fields

Fields	What you get
id, url, title, country, operation, propertyType, typology, subTypology	Listing — 112272495, web link, title, es, sale, homes, flat, independantHouse
price, currency, pricePerM2, previousPrice, priceDropValue, priceDropPercent, priceDropDate	Price — sale price or monthly rent, EUR, €/m², price before the last drop, drop in € and %, ISO date
size, rooms, bathrooms, floor, condition	Property — m², bedrooms, bathrooms, 2 / bj (ground), good / renew / newdevelopment
hasLift, isExterior, hasParkingSpace, parkingIncludedInPrice, parkingPrice, hasAirConditioning, hasSwimmingPool, hasTerrace, hasGarden, hasBoxRoom	Property — true / false / null
labels, isNewDevelopment, isNewListing, isTopHighlight, isVisualHighlight, isTopPlus, isUrgent	Badges — idealista labels, new build, new on idealista, paid highlights
address, addressVisible, neighborhood, district, municipality, province, locationId, latitude, longitude	Location — the line idealista shows on the results page (Piso en Calle de Goya, Recoletos, Madrid: type, street when shown, area, city), whether the exact address is shown, idealista location ID, GPS
description, highlightPhrase	full description, the advertiser's highlight phrase
thumbnail, images, imageTags, imageCount, videos, virtualTours, hasVideo, has3DTour, has360, hasPlan, hasHomeStaging	Photos and media — photo links and the room of each (livingRoom, kitchen…), videos, 3D tours
advertiserName, contactName, advertiserType, phone, phoneFormatted, agencySlug, agencyUrl, agencyLogo, externalReference	Advertiser — name, contact, professional / private, +34919381590, 919 38 15 90, agency page, logo, the advertiser's reference
updatedAt, street, communityCosts, energyCertificate, energyConsumption, emissionsRating, furnished	Listing page — last update (ISO), street alone (Calle de Goya, 135), monthly community costs, energy rating, kWh/m² year, emissions, furnishing
builtArea, usableArea, plotArea, isPenthouse, isDuplex, isStudio, isTopFloor, yearBuilt, heating, orientation, features, descriptionLanguages	Listing page — m², flags, 1950, Central heating: gas (or No heating), east, west, every feature line, languages of the description
agencyAddress, agencyPostalCode, agencyCity, agencyWebsite, agencyId, agencyPhrase, allowsCounterOffers, allowsRemoteVisit	Agency (listing or agency page) — office address, postal code, city, website, idealista agency number, slogan, counter-offers, remote visits (listing page)
agencySinceYear, agencyListingsCount, agencyCoverImage, agencyVideo, agencyPhone, agencyLatitude, agencyLongitude	Agency (agency page) — year it joined idealista (2001), listings on idealista (47), cover photo, video, office phone (+34919382902), office GPS
email	Agency — e-mail found on the agency website (enrichEmails)
search, scrapedAt	the search that found the listing, ISO timestamp

💡 Tips

How to get more results

Set maxItems to 0 and keep Split large searches on: a search of more than 2,500 listings (idealista's own limit per search) is read by price ranges, so a whole city comes out. Several cities or districts in locations also widen the run.

How to reduce costs

The price is per listing, so the levers are maxItems, maxItemsPerQuery, the filters (a filtered-out listing is not saved and costs only the filter fee, see above) and onlyNew for recurring runs (you never pay twice for the same listing). Leave Open each listing page off unless you need its fields: the search already gives the price, the GPS, the description and the phone number.

Several searches in one run

Fill locations and / or searchQueries: the Actor runs one search per location × keyword (up to 500 per run), plus one per agency, point, area or search URL — with no location, each of those is searched once per keyword (500 at most) instead. A listing found by several searches is saved — and charged — once. Set maxItemsPerQuery to give every search its own cap: without it the first searches can use up the whole maxItems budget.

Monitoring: only the new listings

Tick Only new listings (onlyNew) and schedule the Actor. The first run returns everything; each later run skips the listings already delivered: they are not saved and not charged. The memory lives in a named key-value store of your account (idealista-listings-scraper-seen, up to 150,000 listings per key) and is only updated with listings that really reached the dataset, so a failed run never hides anything. Give each schedule its own stateKey, and tick resetState once to start over. Searches are then sorted by newest (unless you pick another Sort by), and a search stops once it meets 250 listings in a row you already have (paid listings pinned at the top are not counted). Add Price drops only to follow the price cuts.

Filter by date

publishedSince is idealista's own filter (published or reduced in the last day, 2 days, week or month) and works on every run. postedAfter and postedBefore read the last update of each listing on its listing page, so they need Open each listing page: a date (2026-09-01, the whole day is included, Madrid time) or a period before now (7 days, 2 weeks, 1 month). Filtered-out listings are not saved and do not count in maxItems; each listing page they drop costs the filter fee (see Pricing).

🔌 Integrations and API

Call the Actor via the Apify API, the JavaScript or Python clients, or connect it with integrations and webhooks (Make, Zapier, n8n, Google Sheets, Slack, Airtable…). The dataset can be fetched as JSON or CSV from any tool.

🤖 Use with AI agents (MCP)

AI agents (Claude, ChatGPT, Cursor…) can find and run this Actor through the Apify MCP server, billed to their Apify account like any run. It returns one item per idealista property listing. Actor id: nice_dev/idealista-listings-scraper; MCP server with this Actor only: https://mcp.apify.com/?tools=fetch-actor-details,nice_dev/idealista-listings-scraper.

Smallest input, for a cheap first call:

{
    "country": "es",
    "operation": "sale",
    "propertyType": "homes",
    "location": "Madrid",
    "maxItems": 10
}

Key output fields: url, title, price, currency, size, rooms, address, phone.

Cost: $0.25 per 1,000 listings plus $0.001 per run start; the options (listing page, agency profile, agency e-mail) and the filters cost extra, see the pricing section above. Cap each call with maxItems and, through the API, with the run option maxTotalChargeUsd.

❓ FAQ

Is it legal to scrape idealista?

The Actor only reads what idealista shows publicly to any anonymous visitor. It logs in to nothing and solves no captcha. Results contain personal data — the name and phone number of the advertisers, private sellers included, and with Find agency e-mails the business addresses published on the agencies' own websites — which is protected by GDPR: you need a lawful basis before using it, and rules for contacting people differ by country. You are responsible for using the data in compliance with idealista's Terms of Use and applicable law. This Actor is not affiliated with idealista.

Does it need a login or a proxy?

No login. The proxy is included in the price: leave the default setting (the residential proxy is not available). A request the site turns away is retried at once on a new proxy session (without a proxy, after a pause of 5 seconds, doubled at each retry up to 150 seconds).

Is the data safe to open in Excel or to show on a web page?

Every phone number starts with + (international format): import the phone column as text in Excel or Google Sheets, or it may be read as a number. Titles and descriptions are the advertisers' own words, copied as they are: a text can begin with -, +, = or @, which a spreadsheet may read as a formula. Every URL field holds an http(s) link or null. On a web page, escape every field like any text written by a stranger.

Known limitations

• idealista shows at most 2,500 listings per search: with Split large searches off, a bigger search stops there.
• A search of more than 2,500 listings is read by price ranges: with a price sort (priceLow, priceHigh) Max listings still gives the cheapest (or dearest) listings of the whole search; with any other sort (newest, size…) it gives listings sorted inside each price range, not the first ones of the whole search.
• The filters written in the path of a pasted search URL are not read: set them with the filter fields.
• Photo links are signed by idealista and stop working 24 hours after the run: download the photos you need before.
• idealista gives no first-publication date, only the last update (on the listing page).
• onlyNew remembers listing codes, not their content: a listing whose price changed is not returned again (use onlyPriceDrops on a separate run for that).

A run the platform stops without warning (out of memory, run timeout)

• Resurrect it: it goes on from where it stood at most a minute before the stop. What it had read since is read again, and the listings already saved are skipped: none is delivered or charged twice, and maxItems still counts them.
• With onlyNew, the memory is saved once a minute: resurrect the stopped run and the listings it had saved meanwhile join the memory; leave it stopped for good, and the next run may return up to a minute of them once more.

Something doesn't work?

The last line of the log counts the listings saved, filtered out and no longer on idealista (removed while the run was reading them), and the requests that failed after every retry. Those requests and the removed listings are listed, with the reason, in the FAILED_REQUESTS record of the run's key-value store. A run that saved nothing and had failed requests fails, and its last message gives the cause. A run that saved some listings but lost at least as many requests as it read fails too ("Most requests failed…"), so that a block after the first page never passes for a finished run: the listings it kept stay in the dataset.

If idealista changes its pages, you are told instead of paying for blank rows. If the first 20 listings read all lack their title, price, GPS, description, photos or type of advertiser (or the phone of every agency) — or, with Open each listing page, their last update, energy certificate or feature lines — the run saves nothing more, stops and fails, and its last message names the missing field: at most those first listings are charged.

🛟 Support

Open an issue in the Issues tab with a link to your run: the run log and the FAILED_REQUESTS record of the key-value store show exactly which searches failed and why.