🏠 Idealista Scraper — Spain · Portugal · Italy Real Estate

Extract real-estate listings from Idealista at scale — properties for sale or rent across 🇪🇸 Spain, 🇵🇹 Portugal and 🇮🇹 Italy. Search by location, paste listing URLs or property codes, apply rich filters, and get clean, structured JSON with prices, sizes, photos, geolocation, agent contacts and (optionally) full property details and engagement statistics.

This Actor talks to Idealista's official mobile-app API, so results are fast, complete and consistently structured — and a smart auto-escalating proxy keeps it running even when requests get blocked.

⭐ Why choose this Actor?

• Fast & reliable — direct mobile-API access, not fragile HTML scraping.
• Self-healing proxies — starts with no proxy, automatically escalates to datacenter and then residential proxies on blocks, then sticks with what works.
• Live results — every property is saved the moment it's ready; a crash never loses finished work.
• Deeply structured output — search fields + optional _details and _stats.
• Bulk-friendly — paste many listing URLs / property codes, or search whole cities.

🔑 Key features

• Sale & rent, 9 property types (homes, new developments, offices, garages, lands…).
• 40+ filters: price, size, bedrooms, bathrooms, condition, floor, amenities, agency…
• Automatic sub-location splitting to exceed the per-search pagination cap.
• Optional per-property enrichment (_details, _stats).
• Real-time, emoji-rich logs and a tabbed Output view (Overview · Location · Features · Contact).

📥 Input

{
  "location": "0-EU-ES-28-07-001-079",
  "country": "es",
  "operation": "sale",
  "propertyType": "homes",
  "maxItems": 50,
  "sortBy": "mostRecent",
  "fetchDetails": true,
  "fetchStats": true,
  "proxyConfiguration": { "useApifyProxy": false }
}

Field	Meaning
startUrls	Bulk Idealista listing URLs; property codes are auto-extracted.
propertyCodes	Idealista property codes to fetch directly (skips search & filters).
location	City name (e.g. Madrid) or Idealista Location ID.
country	es · pt · it.
operation	sale or rent.
propertyType	homes, newDevelopments, offices, premises, garages, lands, storageRooms, buildings, bedrooms.
maxItems	Max listings (0 = unlimited; >2500 auto-splits by sub-location).
sortBy	Result ordering (most recent, lowest price, biggest…).
fetchDetails / fetchStats	Add _details / _stats per property (slower).
Price/size/filters/amenities	See the input form — all optional.
proxyConfiguration	Proxy. Default: no proxy with auto-escalation.

📤 Output

Each dataset item is a full Idealista listing. With enrichment on, it also carries _details (full description, all photos, characteristics, agent info) and _stats (views, favourites, contacts):

{
  "propertyCode": "111666344",
  "operation": "sale",
  "propertyType": "flat",
  "price": 700000,
  "priceByArea": 5645,
  "size": 124,
  "rooms": 4,
  "bathrooms": 2,
  "status": "good",
  "address": "Piso en Calle de Fermín Caballero, 85, Peñagrande, Madrid",
  "province": "Madrid",
  "municipality": "Madrid",
  "district": "Fuencarral",
  "neighborhood": "Peñagrande",
  "latitude": 40.4794993,
  "longitude": -3.7182544,
  "thumbnail": "https://img4.idealista.com/...",
  "url": "https://www.idealista.com/inmueble/111666344/",
  "_details": { "...": "full property detail" },
  "_stats":   { "views": { "value": 0 }, "favorites": { "value": 0 } }
}

🚀 How to use the Actor (via Apify Console)

1. Log in at https://console.apify.com → Actors.
2. Open Idealista Scraper.
3. Set a location (or paste URLs / property codes) and tune filters.
4. (Optional) Enable Fetch details / stats for richer data.
5. Click Start and watch the real-time logs.
6. Open the Output tab — switch between Overview · Location · Features · Contact views.
7. Export to JSON / CSV / Excel or pull via the API.

🏙️ Best use cases

• Market analysis & price benchmarking by area.
• Lead generation for agencies and investors.
• Building property datasets for ML / dashboards.
• Monitoring new listings with publicationDate filters.

💸 Pricing

This Actor uses pay-per-event pricing: a small charge when the run starts plus a small charge per property saved. You only pay for results you receive.

❓ FAQ

Where do I find a Location ID? Use the Idealista Location Search tool, or just type a city name and the Actor resolves it.

Why enrichment is slower? _details/_stats each add one request per property (~50× more requests), so enable them only when you need that depth.

Do I need a proxy? No. The Actor starts without one and escalates automatically only if Idealista blocks the request.

⚖️ Legal & ethics

Only public listing data is collected. You are responsible for complying with applicable laws and Idealista's Terms of Service in your jurisdiction.

🛟 Support

Found a bug or need a new field? Open an issue on the Actor's Issues tab in the Apify Console.