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)

Field	Type	Description
country	string	es · it · pt
operation	string	sale · rent · share · transfers
propertyType	string	homes · offices · premises · garages · bedrooms · lands · storageRooms · buildings · newDevelopments · transfers

Search targeting

Field	Type	Description
searchType	string	auto (default) · locationIds · zoiId · phone · center
locationPrefix	string	City or area name — used for auto search
locationIds	string	Direct location ID (advanced, skips auto-resolve)
phone	string	Agent phone number for phone-based search
center	string	lat,lng for GPS radius search (e.g. 40.4168,-3.7038)
distance	integer	Radius in meters around center

Pagination & sorting

Field	Type	Default	Description
maxProperties	integer	100	Maximum total items to extract
sortBy	string	publicationDate	publicationDate · weigh · price · size
sinceDate	string	-1	Filter by publish date: -1 (all) · T (today) · W (week) · M (month)

Price & size filters

Field	Type	Description
minPrice / maxPrice	integer	Price range (€)
minSize / maxSize	integer	Size range (m²)
minRooms	integer	Minimum bedrooms
minBathrooms	integer	Minimum bathrooms
minTransferCost / maxTransferCost	integer	Transfer cost range (for transfers operation)

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)

Field	Options
energyEfficiency	high · medium · low
furnished	-1 (any) · furnished · furnishedKitchen
preservations	newDevelopment · good · renew
floorHeights	topFloor · intermediateFloor · groundFloor
subTypology	independantHouse · semidetachedHouse · terracedHouse · apartamentoType

Commercial-only filters

Field	Description
ubication	Location type for commercial properties
commercialActivitySubcategories	Commercial activity subcategory
businessOperationType	Business operation type

Output options

Field	Type	Default	Description
fetchFullDetails	boolean	false	Fetch full detail page for each property (slower, more data)
generateMarketStats	boolean	false	Append a market stats summary item to the dataset
customMapFunction	string	—	JS function to transform each item before saving
debug	boolean	false	Save raw API responses to Key-Value Store

---

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