Idealista Scraper — Extract Listings, Prices & Agency Contacts

Pricing

Rating

Developer

Actor stats

Categories

Share

Scrape Idealista real estate listings across Spain, Italy & Portugal. Extract price, GPS coordinates, energy rating, rooms, size, photos, and agency contact from any city, region, or full Idealista search URL. DataDome bypass included via stealth browser + residential proxy.

Built for property investors, proptech teams, market analysts, and data brokers who need a reliable Idealista API alternative without fighting anti-bot protection.

👁 Apify
👁 TypeScript
👁 Pay Per Event

What does Idealista Scraper do?

• Extract Idealista listings across Spain (idealista.com), Italy (idealista.it), Portugal (idealista.pt)
• Filter by operation (sale / rent), property type, price, size, bedrooms, bathrooms, and 15+ amenity flags
• Returns GPS coordinates, energy rating, price/m², rooms, photos, agency contact
• Up to 1,800 listings per search (Idealista's hard cap)
• Handles DataDome anti-bot automatically — stealth Playwright + warmed residential profile
• Optional detail-page enrichment: address, geo, bathrooms, full amenities, agency phone
• Works on Apify Free plan — proxy rotation, scheduling, webhooks, REST API included

Why scrape Idealista?

Idealista is the dominant real estate platform in Southern Europe (60M+ monthly visits). Its public listing data is the canonical price signal for:

• Investors — yield analysis, neighborhood price tracking, comp sets across Madrid / Barcelona / Milan / Lisbon
• Proptech & valuation models — feed AVMs with GPS-accurate, energy-rating-tagged comps
• Real estate agencies — competitive monitoring of competitor inventory and pricing
• Researchers & journalists — Southern European housing dynamics, EU energy-certificate analysis

Idealista has no public API. This scraper is the practical alternative.

What data can Idealista Scraper extract?

How to scrape Idealista listings

Quick start

1. Open Idealista Scraper on Apify and click Try for free
2. Pick Country (Spain / Italy / Portugal) and Operation (sale / rent)
3. Enter a Location — either a slug like madrid-comunidad_de_madrid or a full Idealista search URL
4. Set Max items (1–1800) and any filters (price, bedrooms, amenities)
5. Toggle Fetch listing details if you need address, geo, agency phone (~10× requests)
6. Click Start — results stream into the dataset; export as JSON / CSV / Excel / HTML / XML or pull via Apify API

Input modes

Search mode (recommended for discovery):

{
"operation":"sale",
"propertyType":"homes",
"country":"es",
"location":"madrid-comunidad_de_madrid",
"maxItems":100,
"sortBy":"mostRecent",
"minPrice":200000,
"maxPrice":600000,
"bedrooms":["2","3"]
}

URL passthrough mode (for precise filtered searches):

{
"startUrls":[{"url":"https://www.idealista.com/venta-viviendas/madrid-madrid/con-precio-hasta_500000,habitaciones_2-3/"}],
"maxItems":500
}

location accepts an Idealista URL slug or a full search URL (passthrough — all UI filters override slug-based behavior). Boolean amenity flags (balcony, terrace, lift, swimmingPool, seaViews, luxury, virtualTour, …) map 1:1 to Idealista's filter UI.

How much does it cost to scrape Idealista?

Pay-Per-Event pricing — you only pay for what you scrape.

fetchDetails: true adds $0.003/listing on top — it does not replace the base charge.

On the Apify Free plan ($5 platform credit), you can extract roughly 5,000+ Idealista listings. No subscription, no platform fees on top.

Output example

{
"listingId":"99887766",
"url":"https://www.idealista.com/inmueble/99887766/",
"locale":"ES",
"price":450000,
"pricePerSqm":4500,
"rooms":3,
"size":100.0,
"energyRating":"B",
"latitude":40.4168,
"longitude":-3.7038,
"title":"Piso en Madrid centro 3 habitaciones",
"propertyType":"flat",
"operation":"sale",
"agencySlug":"inmobiliaria-centro",
"agencyName":"Inmobiliaria Centro Madrid",
"agencyPhone":null,
"amenities":["lift","balcony","air-conditioning"],
"photos":["https://img4.idealista.com/blur/..."],
"priceHistory":null,
"scraped_at":"2026-06-24T10:00:00.000Z",
"source_url":"https://www.idealista.com/venta-viviendas/madrid-madrid/"
}

Download the full dataset as JSON, CSV, Excel, HTML, or XML from the Storage tab, or pull it via the Apify API.

Tips

• Start narrow. Idealista caps results at ~1,800 per search. Split big metros by district or property type.
• Skip fetchDetails first. The list-page data covers price, size, rooms, energy rating, GPS for most use cases. Only enable details when you need agency phone or full amenities.
• Bring your own proxy for hardened DataDome targets. Spanish residential IPs from Decodo / Bright Data / IPRoyal outperform shared pools.
• Schedule incremental runs with publicationDate=W (last week) or T/Y (last 24/48h) to track new inventory cheaply.
• Geo-fence with the slug. madrid-comunidad_de_madrid ≠ madrid-madrid — first is the region, second is the city.

Integration

JavaScript / TypeScript

$npminstall apify-client

import{ ApifyClient }from'apify-client';
const client =newApifyClient({token:'<YOUR_API_TOKEN>'});
const input ={
operation:'sale',
propertyType:'homes',
country:'es',
location:'madrid-madrid',
maxItems:100,
};
const run =await client.actor('USERNAME/idealista-scraper').call(input);
const{ items }=await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

Python

$pip install apify-client

from apify_client import ApifyClient
client = ApifyClient('<YOUR_API_TOKEN>')
run = client.actor('USERNAME/idealista-scraper').call(run_input={
'operation':'sale',
'propertyType':'homes',
'country':'es',
'location':'madrid-madrid',
'maxItems':100,
})
for item in client.dataset(run['defaultDatasetId']).iterate_items():
print(item)

CLI

echo'{ "operation": "sale", "country": "es", "location": "madrid-madrid", "maxItems": 50 }'|\
apify call USERNAME/idealista-scraper --silent --output-dataset

MCP server (for Claude / Cursor / ChatGPT)

{
"mcpServers":{
"apify":{
"command":"npx",
"args":[
"mcp-remote",
"https://mcp.apify.com/?tools=USERNAME/idealista-scraper",
"--header",
"Authorization: Bearer <YOUR_API_TOKEN>"
]
}
}
}

Is it legal to scrape Idealista?

Our scrapers are ethical and do not extract any private user data, such as email addresses, gender, or location. They only extract what the user has chosen to share publicly. We therefore believe that our scrapers, when used for ethical purposes by Apify users, are safe. However, you should be aware that your results could contain personal data (e.g. agent phone numbers published on the listing). 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.

FAQ

Does it bypass Idealista's DataDome anti-bot? Yes. The actor uses Playwright with stealth mode + pre-warmed residential proxy profiles tuned for DataDome. For aggressive blocking, plug in a premium ES residential proxy via customProxyUrl.

Can I scrape Spain, Italy, and Portugal in one run? One country per run — the country input is single-select (es / it / pt). Schedule three runs in parallel; Apify routes each to the correct residential proxy region.

Is there an official Idealista API? Idealista offers a partner API to licensed real estate agencies only (no public access, requires application + commercial agreement). This actor is the practical alternative for everyone else.

What's the 1,800-listing cap? Idealista limits search results to ~1,800 per query. For larger markets, split by district, property subtype, or price band. Combine results downstream.

How fresh is the data? Live — every run hits Idealista directly. Schedule runs hourly / daily via Apify Scheduler for continuous monitoring.

Support

For feature requests, custom scraping work, or dedicated SLAs, contact us through the Apify Store actor page.