Idealista Scraper: Spain, Italy & Portugal Real Estate
Pricing
from $0.23 / 1,000 listings
Idealista Scraper: Spain, Italy & Portugal Real Estate
Idealista scraper for Spain, Italy and Portugal: homes for sale or rent, rooms, new builds and commercial property with price, size, rooms, GPS, photos, the advertiser's name and phone, and price drops. Optional agency profile and e-mail. Export JSON, CSV or Excel.
Pricing
from $0.23 / 1,000 listings
Rating
0.0
(0)
Developer
Nice Dev
Maintained by CommunityActor stats
0
Bookmarked
14
Total users
8
Monthly active users
5 days ago
Last modified
Categories
Features
Share
🏠 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. It works as an Idealista API alternative: run it on a schedule, call it from your code, or plug it into Make, Zapier or n8n.
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, 182 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 |
| 🧾 More from the cards and pages | publication date and days on the market, auction flag, rooms to share and holiday rentals (flatmates, guests, price line), new-development programme with its homes, business and premises details, luxury mark, staged photos, phone numbers and e-mails written in the description, agent name and reply time, building and layout lines, photo details, original language and, on request, the description in every language |
| 🔎 Description tags | sea view, needs renovation, tenant in place, tourist licence, investment pitch, new or renovated — read from the description, free — true, false |
| 📄 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, plus the social profiles (Facebook, Instagram, LinkedIn, X, YouTube, TikTok) found on that website |
| 📊 Zone market statistics (option) | for each zone of the run (district or city): price quartiles, price per m², gross rental yield, best-value listings, private sellers, price drops, and the local rules (tourist rentals, rent caps, purchase tax) — with an optional AI-written summary of each zone |
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, those marked (statistics) when Add the listing statistics (includeStats) 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.
- 🎯 100+ filters: price, size, bedrooms, bathrooms, condition, floor, energy rating, lift, parking, terrace, pool, auctions, bank properties, tenanted or free, furnished, the filters of offices, premises, businesses for transfer, land, new builds and holiday rentals (with the dates of the stay), and every filter of rooms to share (gender, couples, pets, smokers…). On top: keywords to keep or drop, price per m², minimum photos, agencies to drop, and a minimum motivated-seller score.
- 🌍 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
- Create a free Apify account.
- Open Idealista Scraper, choose the Country, Operation (sale or rent) and Property type, and type a Location (e.g.
Madrid). - Or paste idealista search, listing or agency URLs into Start URLs, listing codes into Listing IDs, or agency names into Agencies.
- Set Max listings (100 by default, 0 = no limit) — and Max listings per search when you run several searches — then click Start.
- 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, shown at the Gold price (without a subscription the listing costs $0.29 per 1,000 and the options a little more): $0.23 per 1,000 listings, phone numbers included — plus $0.01 per run start. Options are charged only when you tick them: $0.15 per 1,000 listings with Open each listing page, $1.39 per 1,000 listings that get their agency's profile (Add the agency profile; private sellers have none, so are not charged), $0.066 per 1,000 listings whose agency e-mail is found (Find agency e-mails) — only the agency's own addresses are kept: those on the domain of its website, or an address (a webmail one included) that carries its name or that of its website; the address of a web agency, a host or a general page is left aside, and $0.17 per 1,000 listings that get their statistics (Add the listing statistics; $0.18 on the Silver plan, $0.22 on Bronze, $0.52 without a subscription). Market figures of each zone of the run cost $0.049 per zone with Add zone market statistics, plus $0.079 per zone that gets its summary with Add a written summary of each zone (up to 20 zones per run; a zone with too few listings, or left without a summary, is not charged). 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.23 per 1,000 listings dropped by Private advertisers only, With phone only, Price drops only or Exclude keywords, and $0.23 per 1,000 listing pages dropped by Updated after / before — $0.29 each without a subscription. Example: 20,000 listings of a city ≈ $4.61; 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}
Give at least one starting point: a location, a keyword, a URL, a listing code, an agency, a metro or train station or a street, an advertiser's phone number, a map point or an area. With none, the Actor runs an example instead of stopping — the listings for sale in Madrid, at most 20 — and says so in the log.
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. |
pointsOfInterest | Every listing near a metro station, a train station or a street, named as idealista lists it (Metro Sol, Madrid). A name idealista does not list is skipped and the log says so. |
phones | Every listing of the advertisers who use these phone numbers, with or without the country code (+34 919 38 38 29, 919383829). A number of another country is refused. |
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, plus the social profiles found on it (no extra page, free) (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. |
includeStats | Add each listing's statistics, as idealista shows them to the advertiser: views, e-mail contacts, times shared, times saved as a favourite. One request per listing. |
includeMarketStats | Add one record, MARKET_STATS, to the run's key-value store: the market figures of each zone (district or neighbourhood of a city, else the city) and property type, worked out from the listings of this run (see Zone market statistics under Output). A side (sale or rent) of a zone needs at least 5 listings with a price and a surface; up to 20 zones, the biggest first. |
includeZoneSummary | Needs includeMarketStats. Add an AI-written summary to each zone: its figures in about 150 words, then the local rules of the zone copied as recorded. Written at the end of the run: about 1.5 to 2.5 minutes per zone, plus about a minute to start. |
language | Language of the descriptions and labels (idealista's translation when the advertiser did not write it). |
includeTranslations | Add the description in every language the listing page gives (descriptionTranslations). Needs includeDetails: without it this has no effect. No extra charge. |
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". homeTypes also has the types of one country (apartments in Spain, farmhouses in Italy, country estates and manor houses in Portugal): a type of one country that the search does not list is left out and the log says so. |
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; new builds and holiday rentals offer the last week and the month only. |
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, heating, hotWater, security, corner, smokeVentilation, motorcycleParking, automaticDoor, barbecue, internet, washingMachine, tv, firstLineBeach, privateGarden, communityGarden, singleParkingSpace, doubleParkingSpace, coveredOutdoorParking, uncoveredOutdoorParking. Some exist for one kind of property only (heating: offices, premises, businesses; hot water: offices; security: offices, garages; corner, smoke extraction: premises, businesses; motorcycle parking, automatic door: garages; barbecue, internet, washing machine, TV, first line of beach: holiday rentals; private and community garden, parking spaces: homes in Italy): one the search does not offer is ignored and the log says so. |
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. |
officeTypes | Offices: private, shared or desk (desks exist for rent in Spain only). |
officeLayout | Offices: openPlan or withWalls. |
officeBuildingType | Offices: exclusive (a building of offices only) or mixed. |
premisesTypes | Commercial premises and businesses for transfer: premises or industrialBuilding. |
premisesLocations | Commercial premises and businesses for transfer: shoppingCenter, street, mezzanine, underground, topFloor, others. |
businessOperation | Commercial premises and businesses for transfer: propertyOnly, propertyWithBusiness or rentedOut (rentedOut exists for sales of premises only; businesses for transfer have propertyWithBusiness only). |
businessActivities | Commercial premises and businesses for transfer, any of: accommodation, barsAndNightclub, catering, foodTrade, tobaccoShop, pharmacy, newsstand, retail, educationalCenter, aestheticAndBeauty, sportsFacilities, professionalServices, laboratory, storehouse, otherCommercialActivities. |
minTransferCost, maxTransferCost | Price asked for taking over the business, in euros: businesses for transfer (Spain, Italy, Portugal) and commercial premises to rent (Spain). Any amount; the exact figure is used. |
landTypes | Land: urban, buildingLand or nonBuildingLand. |
newDevelopmentTypes | New builds: developments of flats and / or houses. |
newDevelopmentStatus | New builds: finished or inProject. |
rentToOwn, stateSubsidized | New builds: only the developments sold with a rent-to-own option; only the state-subsidised ones (Spain). |
minGuests | Holiday rentals (Spain and Portugal): places for at least this many guests, from 1 to 20. |
vacationRentalTypes | Holiday rentals: apartment, house and / or villa. |
checkIn, checkOut | Holiday rentals (Spain and Portugal): first and last day of the stay, written YYYY-MM-DD, both together, today or later. Only the places free for those dates are returned and the price becomes the price of the whole stay (700 for 5 nights, not the price of one night); the stayNights column gives the nights. |
roomGender | Rooms to share: female or male. |
roomOccupation | students or workers. |
roomBedType, roomFlatmates, roomRules, roomAvailableFrom, roomAvailableTo | Bed, flatmates, house rules (smoking, pets, couples, children, private bathroom, online booking…), move-in and move-out dates of a room to share. "No smoking" with "smoking allowed", or "no pets" with "pets allowed", is refused. |
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 WHOLE words (case and accents ignored): "art" drops "Art deco", not "Smart watch". Several words in one entry ("hand made") must appear together. |
includeKeywords | Keep only the listings whose title or description contains at least one of these WHOLE words (case and accents ignored): "bar" keeps "Bar and terrace", not "Barcelona". Several words in one entry ("sea view") must appear together. Works together with excludeKeywords. |
minPricePerM2, maxPricePerM2 | Price per square metre between these two amounts, in euros (per month for rentals). Listings with no price per m² (garages, holiday rentals…) are dropped when one is set. |
minPhotos | Only the listings with at least this many photos. |
excludeAgencies | Drop the listings of these agencies: the agency name as idealista shows it, or its page name ("gilmar"). The whole name must match, so "gilmar" does not drop "Gilmar Norte". Private advertisers stay. |
minMotivatedSellerScore | Only the listings whose motivated-seller score (the "motivatedSellerScore" column) is at least this value (0 to 100). It uses the score of the search result: the signals that only the listing page gives (a long-ago update) are not counted, so a listing can score a little higher in the saved data. |
privateSellersOnly, professionalSellersOnly, requirePhone | Keep only private advertisers; keep only agencies and developers (not together with the previous one); 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: 182 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": [],"agencySocials": null,"motivatedSellerScore": 0,"motivatedSellerReasons": [],"seaView": false,"needsRenovation": false,"tenantInPlace": false,"touristLicence": false,"investmentPitch": false,"newOrRenovated": false,"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 182 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 |
lastSeenPrice, priceChange, priceChangePct, priceChangedAt | Price tracking — null in every row for now: filled only on a listing that comes back because its price changed since the run that delivered it (price at that run, change in € and %, ISO date) |
aiLabelMatches | AI label — null in every row for now: filled only with the AI label option, which is not on sale yet (the labels you wrote that apply to the listing description, each with its score) |
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, hasMediaByIdealista, imagesByIdealista, virtualToursByIdealista | Photos and media — photo links and the room of each (livingRoom, kitchen…), videos, 3D tours, whether idealista made some of the media and how many photos / 3D tours (listing page) |
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, emissionsValue, furnished | Listing page — last update (ISO), street alone (Calle de Goya, 135), monthly community costs, energy rating, kWh/m² year, emissions rating, emissions in kg CO₂/m² year, 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, isBankOwned, smokingAllowed | Agency (listing or agency page) — office address, postal code, city, website, idealista agency number, slogan, counter-offers, remote visits (listing page), advertiser is a bank (listing page), smoking allowed (room listings) |
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 |
views, emailContacts, sharedWithFriends, favorites | Statistics (statistics) — views (615), e-mail contacts (2), times shared (0), times saved as a favourite (21) |
email, agencySocials | Agency — e-mail found on the agency website (enrichEmails); agencySocials = the social profiles found on that website ({ facebook, instagram, linkedin, x, youtube, tiktok }, a link or null each), delivered even when no e-mail is found, and never charged |
motivatedSellerScore, motivatedSellerReasons | Motivated seller (included, free) — a 0-100 note and the codes behind it (price_drop_5, urgent, bank_owned, auction, occupied, private_seller, stale_90d…). Rule-based, from the listing's own fields, not a prediction: price drop, urgent flag, bank flag, auction flag, bank / auction / occupied labels, private seller, age of the last update (listing page only). null when no signal can be read, 0 when every signal read is false |
seaView, needsRenovation, tenantInPlace, touristLicence, investmentPitch, newOrRenovated | Description tags (included, free) — six yes / no columns read from the description of the listing (the listing page text with Open each listing page, the search card text without it), in English, Spanish, Italian, Portuguese and Catalan: sea view, needs renovation, tenant in place (rented or occupied), tourist licence, investment pitch, new or renovated. Read from the description, free, and indicative: a keyword reading, not a check on site; where the site gives the fact itself (condition « to renovate », new development, « occupied » label) its flag comes first. null when the listing has no description |
publishedAt, daysOnMarket, isAuction, auctionDate | Dates and auctions — first publication date (ISO; rent and room listings only) and days on the market at the time of the run, auction flag (mostly Italy: the search card first, then the listing page) and the auction date |
flatmatesCount, tenantsCount, tenantsGender, onlineBooking, maxGuests, priceText, stayNights | Rooms and holiday rentals — people already living there, tenants wanted and their gender (mixed), online booking, guests allowed, the price line idealista shows (From 52 €/night, or 700 €/5 nights when the search has dates); stayNights = nights of the stay when the search has check-in and check-out dates (the price is then the whole stay), null otherwise |
developmentName, isDevelopmentFinished, isRentToOwn, developmentUnits, developmentUnitsCount | New developments — name of the programme, finished or not, rent to own; developmentUnits = the homes of the programme (200 at most) with link, price, floor, size and rooms (listing page), and how many it has (listing page) |
transferPrice, mainPriceType, premisesLocation, availableFromText, hasAccess24h, hasTenants, premisesType, premisesFeatures, buildingUses | Businesses, premises, offices, buildings — price asked for the transfer, which price comes first, where the premises are (onTheStreet), availability line, 24-hour access, tenants in place; premises type and equipment, uses of the building (listing page) |
highlightGroup, isLuxury, homeStagingImages | Badges and staging — paid highlight group (Top, Top+, Featured), true when idealista marks the listing as luxury (null otherwise, never false), the staged photos (link, room) |
phoneNeedsLogin, searchTotalResults, descriptionPhones, descriptionEmails | Contact and search — true when idealista shows the phone only to a logged-in user; total results of the search that found the listing (of the price band when a large search is split); phone numbers and e-mail addresses written in the description (empty list when none) |
listingState, agentName, agentPhoto, responseTimeHours, chatEnabled | Agent (listing page) — state of the listing, name and photo of the agent, usual reply time in hours, chat on or off |
flatLocation, floorDescription, layoutDescription, energyCertificateText, buildingFloors, liftsCount, parkingSpacesCount, roomDistributionCount, garageType | Building and layout (listing page) — internal / external, floor and layout lines as written, energy text (Exempt property), floors and lifts of the building, parking spaces, rooms in the layout, garage type |
imageDetails, aiGeneratedImagesCount, hasProfessionalVideo, virtualTourTypes | Photo details (listing page) — every photo with room, width, height and whether it is AI-generated, how many photos are AI-generated, video made by idealista, kinds of virtual tour |
originalLanguage, autoTranslatedLanguages, descriptionTranslations | Languages (listing page) — language the advertiser wrote in, languages added by idealista's translation; descriptionTranslations = the description in each language, filled with Add the description in every language (includeTranslations) |
search, scrapedAt | the search that found the listing, ISO timestamp |
📊 Zone market statistics
With Add zone market statistics, the run also writes one record, MARKET_STATS, to its key-value store (linked in the Output tab; nothing is added to the dataset). It holds one entry per zone — the district of a city, else its neighbourhood, else the city — and property type, worked out from the listings of this run only, nothing estimated:
- sale and rent side by side, each kept with at least 5 listings that have a price and a surface: listings, price (lowest, quartiles, highest), price per m² quartiles, median size, rooms, share of private sellers, price drops, the listings' age (with Open each listing page), a
dealstable that scores every listing against the median price per m² of its zone (cheapest first) andbestDeal; grossYieldPercent: median rent per m² × 12 / median sale price per m², when the run holds both sale and rent for the zone;regulations, for Spain, Italy and Portugal: the local rules of the zone's city, region and country (tourist rentals, rent rules and caps, purchase and property taxes, tourist taxes), each with its status (in_force,expired,unverified), legal basis, dates and official source links;nullfor a place or a country without rules on record. The rules of the country itself are written once per country, innationalRules. Regulatory notes are an informational summary of public rules compiled from official sources, not legal or tax advice: always check the linked official source before acting.
Up to 20 zones per run, the biggest first. With Only new listings, only the listings delivered in this run count.
With Add a written summary of each zone, each zone also holds summary: an AI-written text of about 150 words, in English, that puts the figures of the zone into sentences without adding to them, followed by the local rules of the zone copied as recorded (never written by the AI). summarySource is ai for a text that matched the figures of its zone, template for the same figures in fixed sentences when it did not (charged the same); both are null for a zone left without a summary, which is not charged. The summaries are written at the end of the run, after the listings and the figures: about 1.5 to 2.5 minutes per zone, plus about a minute to start — give the run the time (Run options → Timeout); a zone the run has no time left for gets no summary and is not charged. A summary only restates the figures of its zone and the recorded rules: it is not advice.
One zone of the record (shortened):
{"zone": "Málaga · Centro","zoneLevel": "district","country": "es","municipality": "Málaga","district": "Centro","propertyType": "homes","currency": "EUR","sale": {"listings": 41,"usable": 41,"price": { "min": 259000, "p25": 435000, "median": 740000, "p75": 835000, "max": 1600000 },"pricePerM2": { "p25": 4414.36, "median": 5711.33, "p75": 6949.15 },"medianSize": 114,"privateShare": 0,"priceDrops": { "listings": 7, "share": 0.171, "medianPercent": 6 },"bestDeal": {"id": "112596171","url": "https://www.idealista.com/inmueble/112596171/","price": 264000,"size": 91,"rooms": 2,"pricePerM2": 2901.1,"gapPercent": -49.2}},"rent": {"listings": 68,"usable": 68,"price": { "min": 750, "p25": 1137.5, "median": 1300, "p75": 1620.75, "max": 3825 },"pricePerM2": { "p25": 15.93, "median": 20, "p75": 25.67 },"medianSize": 65},"grossYieldPercent": 4.2,"regulations": { "country": "ES", "region": "Andalucía", "city": "Málaga", "asOf": "2026-10-05" },"summary": "The Málaga Centro district offers 41 properties for sale with a median asking price of €740,000. The median surface area for these listings is 114 m². […] The gross rental yield is 4.2%.\n\nLocal rules (verified, copied as recorded):\n- [Málaga] New tourist dwellings are suspended in the whole municipality from 23 August 2025 for up to three years, or until the planned PGOU amendment is approved if earlier.\n- [Andalucía] Resale property purchases are taxed at a flat 7% transfer tax (ITP).","summarySource": "ai"}
💡 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 — with a cap (Max listings or Max listings per search) below 250, once it has met 80 % of that cap in all (paid listings pinned at the top are not counted). Add Price drops only to follow the price cuts. A listing one of your filters dropped (and charged its filter fee) is remembered for the same filters: the next runs neither read it again nor charge it again.
AI label (not on sale yet)
The AI label option will let you write your own labels (seaview, needs renovation: the flat must be refurbished) and tag every listing whose description fits one: aiLabelMatches lists the labels that apply, each with a score from 0 to 1 ([] when none applies, null when the description is empty or could not be read). It is charged as AI label, per listing and per label, and needs 1 GB of memory at least. It is not available in the form yet.
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.23 per 1,000 listings (Gold price) plus $0.01 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).
onlyNewremembers listing codes, not their content: a listing whose price changed is not returned again (useonlyPriceDropson 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
maxItemsstill counts them. - With
onlyNew, the memory is saved after each write (at most once every 2 seconds): 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 the listings of its last 2 seconds 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 search idealista has no answer for (a place it refuses: HTTP 404) is a warning, not a failed request: the run ends green and its last message says which search was not found. A run that saved nothing and had failed requests fails, and its last message gives the cause; without a proxy, a refused IP is said as such (turn the proxy on). 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.