Idealista Scraper — Extract Listings, Prices & Agency Contacts

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.

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?

Field	Type	Description
listingId	string	Idealista internal listing ID
url	string	Canonical listing URL
locale	ES | IT | PT	Country site
price	number	Asking price (€)
pricePerSqm	number	Price per m²
rooms	number	Bedroom count
size	number	Square meters
energyRating	A–G | null	EU Energy Performance Certificate
latitude / longitude	number	GPS coordinates
title	string	Listing headline
propertyType	string	Home / office / land / etc.
operation	sale | rent	Listing operation
agencySlug / agencyName	string	Listing agent identifier
agencyPhone	string	Agency contact phone (fetchDetails)
amenities, photos	array	Features + image URLs
priceHistory	array	Historical price changes (fetchDetails)
description	string	Full listing text (fetchDetails)
scraped_at	string ISO	Scrape timestamp
source_url	string	Traceability URL

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.

Event	Price	When charged
Actor Start	$0.007	Once per run (per GB memory)
Result item	$0.00085	Per listing scraped from search page
Enriched listing	$0.003	Per detail page visit (only with fetchDetails: true)

Volume	Cost (search only)	Typical use
1,000 listings	~$0.85	One city district, full sweep
10,000 listings	~$8.50	~5 metro searches across Spain
100,000 listings	~$85.00	Full Madrid + Barcelona + Valencia snapshot

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

$npm install apify-client

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ 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.