Idealista API Scraper

The strongest and most complete Idealista scraper on Apify.

Uses the official API → never blocked, super fast, and returns clean structured data.

✨ Key Features

• Official API (fast & reliable)
• Auto beachfronts & special zones (zoiId)
• Agent phone search (find all properties by one phone number)
• GPS radius + 8-point polygon shape search
• Every official filter (energy efficiency, furnished, floor level, commercial activities, etc.)
• Full property details + all images
• Custom JavaScript mapping function (add price/m², yield, CRM tags, etc.)
• Market statistics summary
• Spain, Italy & Portugal support

🚀 Quick Start

1. Set Country, Operation and Property Type
2. Type a city name in Location Name (or use GPS / phone)
3. Choose how many properties you want
4. Enable Fetch Full Details and Market Stats
5. Run!

Input Fields (most important)

• locationPrefix – city or area name
• phone – agent phone search
• center + distance – GPS radius
• energyEfficiency, ubication, commercialActivitySubcategories – multi-select
• customMapFunction – your own JS logic

Output

Clean JSON with:

• Price, size, rooms, bathrooms
• Full description & all image URLs
• Energy certificate, features, coordinates
• pricePerM2, custom fields (via customMapFunction)
• Market stats summary item

Use Cases

• Real estate investment analysis
• Rental yield tracking
• Lead generation for agents
• Competitor analysis

Quick Start Examples

Copy any of the examples from the README and run instantly.
Supports city name, beachfronts, agent phone, GPS radius

🚀 Quick Start Prompts

{
    "country": "es",
    "operation": "sale",
    "propertyType": "homes",
    "locationPrefix": "Madrid",
    "maxProperties": 200,
    "fetchFullDetails": true,
    "generateMarketStats": true
}

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

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

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

{
    "country": "es",
    "operation": "sale",
    "propertyType": "homes",
    "locationPrefix": "Valencia",
    "maxProperties": 1000,
    "minPrice": 200000,
    "maxPrice": 800000,
    "elevator": true,
    "energyEfficiency": ["high"],
    "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 API

Need help or custom features? Open an issue or message me on Apify.