Pricing

Rating

Developer

Actor stats

Categories

Share

Idealista API Scraper

The strongest and most complete Idealista scraper on Apify.

Uses the official mobile API — fast, structured, and resilient via built-in residential proxy routing.

✨ Key Features

• Official Android API (never blocked, returns clean JSON)
• Built-in residential proxy — works out of the box, no setup required
• Auto ZOI detection for beachfronts & special zones (zoiId)
• Agent phone search (all listings by one phone number)
• GPS radius + polygon shape search
• Every official filter (price, size, rooms, energy rating, furnished, floor level, commercial activity, etc.)
• Full property details + all image URLs
• Custom JavaScript mapping function (price/m², yield, CRM tags, etc.)
• Market statistics summary
• Spain 🇪🇸, Italy 🇮🇹 & Portugal 🇵🇹

🚀 Quick Start

1. Set Country, Operation, and Property Type
2. Type a location name in Location Name (e.g. Eixample, Barcelona)
3. Set Max Properties
4. Optionally enable Fetch Full Details
5. Run!

No proxy configuration needed — it's handled automatically.

Input Reference

Core (required)

Search targeting

Pagination & sorting

Price & size filters

Feature filters (booleans)

elevator · garage · garden · swimmingPool · terrance · airConditioning · petsAllowed · seaViews · balcony · builtinWardrobes · storeRoom · accessible · exterior · heating · corner · smokeVentilation · bankOffer · hasPlan · virtualTour

Quality filters (multi-select arrays)

Commercial-only filters

Output options

Output

Each item is a JSON object containing:

• propertyCode, address, price, priceInfo
• size, rooms, bathrooms, floor
• propertyType, operation, country
• description, thumbnail, image galleries
• Energy certificate, features, coordinates
• Full detail fields when fetchFullDetails is enabled

Quick Start Examples

Homes for rent in Barcelona:

{
"country":"es",
"operation":"rent",
"propertyType":"homes",
"locationPrefix":"Eixample, Barcelona",
"maxProperties":200,
"fetchFullDetails":true
}

Sale listings in Madrid with price filter:

{
"country":"es",
"operation":"sale",
"propertyType":"homes",
"locationPrefix":"Madrid",
"maxProperties":500,
"minPrice":200000,
"maxPrice":800000,
"elevator":true,
"energyEfficiency":["high"],
"fetchFullDetails":true,
"generateMarketStats":true
}

Beachfront properties (ZOI auto-detected):

{
"country":"es",
"operation":"sale",
"propertyType":"homes",
"locationPrefix":"primera línea de playa Torrevieja",
"maxProperties":300,
"fetchFullDetails":true
}

All listings by agent phone:

{
"country":"es",
"operation":"rent",
"propertyType":"homes",
"searchType":"phone",
"phone":"666123456",
"maxProperties":100
}

GPS radius search:

{
"country":"es",
"operation":"sale",
"propertyType":"homes",
"searchType":"center",
"center":"40.4168,-3.7038",
"distance":5000,
"maxProperties":150
}

Custom price-per-m² field:

{
"country":"es",
"operation":"sale",
"propertyType":"homes",
"locationPrefix":"Valencia",
"maxProperties":1000,
"fetchFullDetails":true,
"customMapFunction":"(item) => { item.pricePerM2 = item.price && item.size ? Math.round(item.price / item.size) : null; return item; }"
}

Made with ❤️ using the official Idealista mobile API