🏠 Idealista Real Estate Scraper (Spain, Italy & Portugal)

Extract comprehensive real estate property listings from Idealista across Spain (idealista.com), Italy (idealista.it), and Portugal (idealista.pt). Collect prices, square meters, bedroom and bathroom counts, floor/lift availability, amenities (parking, terrace), precise location, and agency contact details.

Engineered with advanced anti-detect browser emulation to seamlessly navigate DataDome protections and deliver reliable, structured data feeds.

---

🌟 Key Features

• Multi-Country Coverage: Full support for Spain (es), Italy (it), and Portugal (pt).
• Flexible Transaction Types: Scrape Rent (alquiler / affitto / arrendar), Sale (venta / vendita / comprar), or Shared Rooms (habitaciones / stanze / quartos).
• Comprehensive Property Metadata:
  • Accurate numerical price and currency (€ EUR).
  • Surface area in square meters ($m^2$).
  • Bedroom & bathroom counts.
  • Floor level and elevator/lift availability (has_lift).
  • Parking / garage and terrace / balcony flags.
  • Property classification (Flat, Chalet, Penthouse, Duplex, Studio, Room).
• Agency vs. Private Seller Detection: Easily distinguish between real estate agencies and direct private owners (Particulares).
• DataDome Anti-Bot Resilient: Built with Camoufox anti-detect browser engine and Apify Proxy integration to bypass anti-scraping challenges.
• Smart Automated Pagination: Traverses search results pages automatically until reaching your requested property quota.

---

💡 Real Estate Use Cases

1. Investment & Rental Yield Analysis: Calculate gross and net rental yields by comparing sale and rent prices across specific neighborhoods.
2. Proptech & Automated Valuation Models (AVM): Train price prediction algorithms and power real estate valuation tools with live market comparables.
3. Deal Sourcing & Below-Market Alerts: Monitor hot areas for newly listed apartments and price drops before competitors.
4. Competitor & Agency Intelligence: Track market share, active inventory, and fee models of regional real estate agencies.
5. Private Seller Lead Generation: Filter listings by is_agency: false to connect directly with property owners.

---

📥 Input Parameters

Parameter	Type	Required	Default	Description
location	String	No	"madrid-madrid"	City or province slug on Idealista (e.g., 'madrid-madrid', 'barcelona-barcelona', 'valencia-valencia', 'sevilla-sevilla', 'malaga-costa-del-sol', 'milano', 'lisboa').
operation	String	No	"rent"	Type of transaction: 'rent', 'sale', or 'room'.
country	String	No	"es"	Country portal: 'es' (Spain), 'it' (Italy), or 'pt' (Portugal).
start_urls	Array	No	[]	Direct search or filtered URLs on Idealista (overrides location if supplied).
max_items	Integer	No	40	Maximum number of listings to collect (1 - 1,000).
min_price	Number	No	null	Optional minimum price filter in EUR (€).
max_price	Number	No	null	Optional maximum price filter in EUR (€).
min_rooms	Integer	No	null	Minimum number of bedrooms required.
proxy_configuration	Object	No	{"useApifyProxy": true}	Apify Proxy configuration for IP rotation and DataDome clearance.

Example Input (Rentals in Madrid)

{
    "location": "madrid-madrid",
    "operation": "rent",
    "country": "es",
    "max_items": 50,
    "min_price": 900,
    "max_price": 2200,
    "min_rooms": 2,
    "proxy_configuration": {
        "useApifyProxy": true
    }
}

Example Input (Properties for Sale in Barcelona)

{
    "location": "barcelona-barcelona",
    "operation": "sale",
    "country": "es",
    "max_items": 100,
    "min_price": 250000,
    "max_price": 600000,
    "proxy_configuration": {
        "useApifyProxy": true
    }
}

---

📤 Output Data Format

Results are saved to the default dataset and can be exported as JSON, CSV, Excel (XLSX), XML, or HTML.

Sample Output Record

{
    "id": "104859632",
    "title": "Piso en calle de Alcalá, Goya, Madrid",
    "price": 1500.0,
    "currency": "EUR",
    "price_formatted": "1.500 €/mes",
    "operation": "rent",
    "property_type": "flat",
    "rooms": 2,
    "bathrooms": 1,
    "size_m2": 85.0,
    "floor": "Planta 3ª exterior con ascensor",
    "has_lift": true,
    "has_parking": true,
    "has_terrace": true,
    "location": "Goya, Madrid",
    "description": "Magnífico piso exterior reformado con terraza y ascensor en pleno barrio de Goya.",
    "agency": "Inmobiliaria Premium Madrid",
    "is_agency": true,
    "url": "https://www.idealista.com/inmueble/104859632/",
    "image_url": "https://img3.idealista.com/blur/WEB_LISTING/0/id/104859632/img1.jpg",
    "scraped_at": "2026-09-24T18:02:00.000Z"
}

---

⚙️ Performance & Configuration

• Recommended Memory: 512 MB – 1024 MB (ideal for headless browser runs).
• Concurrency & Speed: ~30–60 seconds per 40 listings with anti-bot evasion delays.
• Export Formats: JSON, CSV, Excel, XML.

---

🔒 Legal & Ethical Notice

This Actor extracts public real estate listings for statistical analysis, market research, and personal productivity. Please adhere to local regulations regarding web data collection and consult Idealista's Terms of Service.