Idealista scraper and API alternative for Spain, Italy and Portugal. Search sale and rental homes, new builds, rooms, garages, offices, land and commercial units by city, search URL, map area or CSV. Rows carry price, size, rooms, price drops, energy rating, photos and agency phones.
All notable changes to Smart Idealista Scraper will be documented in this file.
[2026-10-29]
🔧 Reliability: Search Results Are Back
Fixed - A degraded upstream data host started returning empty result pages that still reported success, so many runs delivered 0 properties. Runs now detect the empty-but-successful pattern, retry through a stable alternate route and return real listings again.
Fixed - The "needs full renovation" property condition now maps correctly to the upstream filter token instead of failing the whole search with an error.
New data safety net - When an empty page still comes back after retries, the run now tells you why in plain language instead of silently returning nothing.
[2026-09-22]
📦 More Per Run, and Charging You Can Check
50 properties per page instead of 40 - The same single request returns 50, so every page you run now gives you a quarter more data.
Search by postal code - New postalCodes field takes one or many codes and searches each separately. Useful when a city boundary is too coarse.
Charging matches delivery exactly - Previously a page charged a flat 30 and gave the rest away. Now every property delivered is charged once, so the number on your bill is the number of rows in your dataset. The per-property price is coming down to match; nothing about the data changed.
Fixed - Runs that did not set a page count could scrape and bill two pages instead of one. They now do exactly what you asked for.
Full photo galleries and extra detail are now a paid option - enrichWithDetails adds complete galleries, videos, tours, floor plans, energy certificate and community costs, charged per enriched property. Standard results still include a cover image and 50+ fields.
New columns - priceByArea, suggestedTexts, topPlus, topNewDevelopment, externalReference, plus yearBuilt, energy, fees and priceHistory now visible in the Output tab.
🖼️ New: Full Photo Galleries, Energy Ratings and Community Costs
Turn on "Fetch full photo galleries and extra detail" - Get every listing photo, video, virtual tour and floor plan instead of just the cover image, plus the energy certificate and monthly community costs for each property. Off by default, so runs stay fast and cheap unless you ask for it.
Price drops, broken out - New priceDropValue and priceDropPercent columns show what came off the asking price, alongside the existing price details.
New columns - currency, labels, highlight, hasParkingSpace, energyCertification, communityCosts, virtualTourUrls and plansUrls.
🔎 Better Filters
Property condition now has five settings instead of two: good, almost new, newly built, needs renovation and to restore.
Filter by floor - ground floor, intermediate, top floor and more.
New filters - owner type (private, professional, bank), sea views, auction listings and free-text amenity search.
⚠️ Filters That Have Been Removed
These filters could no longer be applied reliably, so they have been removed rather than left in place returning unfiltered results:
Bathroom count, published-since, and "fully furnished" (the furnished-kitchen option remains)
Occupancy filters: bare ownership, tenanted, illegally occupied, vacant possession
Narrow house and flat sub-types: villa, cortijo, terraced, semi-detached, detached, apartamento, loft, casa baja
If your saved input still sets one of these, the run stops immediately with a message naming the filter — before anything is charged. Remove the filter and run again. Use the property-type selector and the new condition and floor filters instead.
🐛 Fixed: Energy Rating Was Always Reported as "C"
Deep listing scrapes reported the energy rating as C for every property, whatever the real grade. The letter is now read correctly — three listings that had been returning "C" now correctly report E, C and B. The consumption and emissions figures were always right; only the letter was wrong.
💎 User Benefits
Every existing output column is unchanged - nothing was renamed or removed, so existing integrations keep working
Photo galleries now return the complete set for a listing, not a partial one
A removed filter can never silently return unfiltered results you would be billed for
🎯 Use Cases
Portals and listing sites pulling complete photo galleries for import
Valuation teams filtering by energy rating and community costs
Investors tracking which listings have cut their asking price and by how much
[2026-08-24]
📄 New: A Run Report After Every Search
Every search mode now writes a report - Search-URL, map-area, deep-listing and agency runs get the same report a city search gets. Open it from the Output tab of any run.
Itemized charges - Every charge on the run, with counts and a total, so what you read matches what you were billed.
Free bonus properties, counted - The report shows how many properties you got beyond the 30 charged on each page.
Best value first - The lowest price per square metre of the whole run, as copy-paste text you can drop into a note or a message.
Failed pages come with a fix - Each missing page says what happened and hands you a one-click retry input to paste straight back into the Idealista scraper.
The report survives a failed run - It is written even when a run ends early, so you can always see what you got and what you paid.
✨ Clearer Console, Clearer Logs
Icons on every column and filter - Property listings, agency profiles, dropdown options and search filters all carry an icon, so scanning the dataset and the input form is faster.
A run log you can follow - Tier benefits up front, a final summary at the end, and property counts that match the charges.
💎 User Benefits
One place to check a run: what came back, what is missing, and what it cost
Retry only the pages that failed instead of re-running the whole search
Faster reading of both the Idealista dataset and the input form
🎯 Use Cases
Market analysts checking coverage before exporting a city dataset to CSV
Lead-gen teams re-running only the agency slugs that came back empty
Property investors sharing the best price-per-m2 find from a run without opening the dataset
[2026-08-23]
🏢 Agency Profiles Bill at Their Published Rate
An agency profile bills as an agency profile - A profile is a bigger unit of work than a single listing, and it now charges the agency-profile rate shown on the pricing page rather than the per-property rate. Slugs that fail are still never charged.
Run report in the Output tab - Every run's HTML summary is now linked from the Output tab, next to the property data.
Ask an AI agent for it by name - The Idealista scraper is discoverable over MCP, so Claude, ChatGPT or Cursor can run a Spanish, Italian or Portuguese property search for you and hand back a table.
💎 User Benefits
Pricing that matches the pricing page, with no surprises either way
Property data and the run summary reachable from the same screen
A property search you can trigger in plain language from an AI assistant
🎯 Use Cases
Agencies building contact lists over MCP without touching the Console
Analysts pulling a Madrid or Lisbon dataset straight into an AI workflow
[2026-07-22]
🏢 Fixed: Property Category now actually filters
Buildings, Offices, Lands, Garages, Rooms, Storage Rooms, Commercial and New Homes searches return that category. The Property Category selector was being ignored, so every location search returned homes regardless of the category picked. Selecting 🏢 Buildings in Madrid now returns buildings (159 listings) instead of homes (17,600+).
Unexpected data-source replies no longer look like "0 properties found." When a reply cannot be read, the run says so instead of finishing successfully with an empty dataset.
[2026-07-02]
🏢 New: Agency Profiles Mode
Agency Profiles from Slugs or URLs - Fill the new agencySlugs field with agency slugs (or full agency page URLs) and get one structured profile per agency: commercial name, phone, office address with GPS, active-since year, languages, and total active listings
Listings-by-Location Breakdown - Each profile includes the agency's portfolio footprint by province, municipality, and district (sale or rent, following your Operation setting)
Works with Your Search Results - Every property row already carries an agencyUrl; paste those straight back in to enrich the agencies behind the listings
Fair Pricing - $0.003 per agency profile (same rate as a property), PAID tier
💎 User Benefits
Build agency contact lists for a city without copying data by hand
See which agencies dominate a neighborhood before reaching out
Failed slugs never bill you — you pay only for delivered profiles
🎯 Use Cases
Lead generation targeting the most active agencies in a market
Competitor mapping: portfolio size and coverage per agency
Enriching scraped listings with the office behind each ad
[2026-06-08]
🛡️ Reliability
Search-by-URL is steadier - When a search link's location can't be read on the first try (an intermittent anti-bot block), the scraper now retries the lookup with a fresh session instead of giving up — so the same URL no longer returns an empty result on a transient hiccup.
[2026-06-07]
🚀 Three New Ways to Search — URL, Map Area & Deep Profiles
Search by URL - Paste any Idealista search link — location and filters detected automatically
Draw-an-Area (Polygon) Search - Every listing inside a hand-drawn map shape, as full property cards
Deep Single-Property Profiles - Energy rating, year built, community fees & IBI, price-change history, floor-plan & 3D-tour links
Spain, Italy & Portugal - Every search mode works across all three Idealista markets
🛡️ Reliability Upgrade
Self-Healing Location IDs - Outdated location codes resolve automatically — old bookmarks, saved tasks, and CSV lists keep working
Rock-Solid Under Load - Automatic retry with smart backoff absorbs traffic spikes; parallel runs no longer drop pages
Clear Errors - Invalid locations return an explicit message instead of silent empty results
💎 User Benefits
Skip location-code lookups — paste a URL or draw on the map and run
Cleaner datasets at any scale: fewer error rows, more properties
Data a standard search can't give you: exact map boundaries and premium property details
🎯 Use Cases
Property investors drawing a precise neighborhood boundary and pulling every listing inside it
Buyer's agents exporting a client's saved Idealista search to a spreadsheet in seconds
Market analysts comparing energy ratings, build years, and price history like-for-like
