🏘️ Idealista Bulk Property Scraper

Extract high-quality real estate data from multiple Idealista property listings across Spain, Portugal, and Italy in a single run.

This actor is designed for bulk property data extraction, processing search result pages and individual property listings efficiently. Perfect for real estate analysts, investors, agencies, and developers who need to scrape dozens or hundreds of properties at once.

---

🔎 What This Actor Does

This bulk scraper processes Idealista search result pages and extracts detailed information from each property listing, including:

• 📌 Title, description, and address
• 💰 Price information
• 📏 Area, number of rooms and bathrooms
• 🖼️ Complete image galleries
• 🏢 Agency details and contact information
• 📍 GPS coordinates and maps
• 🔧 Property features (terrace, elevator, AC, etc.)
• ⚡ Energy performance ratings
• 🏗️ Building characteristics

Key Features:

• Bulk Processing: Handle multiple search URLs simultaneously
• Unlimited Extraction: Bypass Idealista's 1,800-property pagination limit
• Resume Capability: Automatically resumes from where it left off if interrupted
• Rate Limiting: Built-in delays to respect server resources
• Error Handling: Robust retry mechanisms for failed requests

---

🛠️ How It Works

This actor uses the Idealista Scraper API internally to extract individual property data. While the API actor processes one property at a time, this bulk scraper:

1. Processes search URLs containing multiple property listings
2. Navigates through properties automatically using smart navigation
3. Calls the single-property API for detailed data extraction
4. Aggregates results into a comprehensive dataset

💡 Cost Efficiency: Instead of manually running the single-property scraper hundreds of times, this actor automates the entire workflow.

---

🌐 Supported Input URLs

You can use this actor with Idealista search result URLs such as:

• https://www.idealista.com/en/geo/venta-obranueva/andalucia/con-2-dormitorios,3-dormitorios,4-dormitorios/pagina-4?ordenado-por=precios-asc
• https://www.idealista.pt/comprar-casas/porto/
• https://www.idealista.it/vendita-case/roma/

The actor will automatically detect the first property on the page and navigate through subsequent listings.

---

⚙️ Input Configuration

{
  "Url": [
    "https://www.idealista.com/en/geo/venta-obranueva/andalucia/con-2-dormitorios,3-dormitorios,4-dormitorios/pagina-4?ordenado-por=precios-asc"
  ],
  "desiredResults": 50,
  "delayBetweenRequests": 600,
  "maxRetries": 3,
  "retryDelay": 600,
  "proxyConfig": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"]
  }
}

Input Parameters

Parameter	Type	Description	Default
Url	Array	List of Idealista search URLs to scrape	Required
desiredResults	Integer	Maximum properties to scrape (0 = no limit)	1
delayBetweenRequests	Integer	Delay between requests (100-2000ms)	200
maxRetries	Integer	Retry attempts for failed requests (0-5)	3
retryDelay	Integer	Initial retry delay (100-2000ms)	200
proxyConfig	Object	Proxy configuration (required)	RESIDENTIAL

---

📊 Sample Output

Each property in your dataset will contain comprehensive information:

{
  "id": "33826216",
  "Url": "https://www.idealista.pt/en/imovel/33826216/",
  "title": "T2 flat for sale in Ponta Delgada (Santa Clara)",
  "price": "399,950 €",
  "description": "Come and discover this amazing apartment located in the heart of Ponta Delgada...",
  "location": "Ponta Delgada",
  "characteristics": [
    "239 m² built, 217 m² floor area",
    "T2",
    "2 bathrooms",
    "Terrace"
  ],
  "building": ["With lift"],
  "amenities": ["Air conditioning"],
  "propertySpecs": {
    "rooms": 2,
    "bathrooms": 2,
    "garden": false,
    "pool": false,
    "terrace": true,
    "constructedArea": 239
  },
  "contactInfo": {
    "agency": "Comprarcasa Ponta Delgada",
    "phones": "+351 296 091 683",
    "reference": "326/A/03635"
  },
  "gallery": [
    {
      "url": "https://img4.idealista.pt/blur/WEB_DETAIL/0/id.pro.pt.image.master/20/ea/c7/267138555.jpg",
      "tag": "Views",
      "isPlan": false
    }
  ],
  "Map": {
    "src": "https://maps.googleapis.com/maps/api/staticmap?size=720x492&center=37.74504040%2C-25.69283370...",
    "addressVisibility": "HIDDEN"
  },
  "scrapedAt": "2025-05-27T01:04:23.968Z",
  "status": "success"
}

---

💰 Pricing Structure

This actor has a two-tier pricing structure:

Main Actor Costs:

• Actor Initialization: $0.002 (charged once per run for setup and input validation)
• Push Success Event: $0.0014 (charged for each successfully scraped property)

Idealista Scraper API Costs (called internally for each property):

• Actor Initialization: $0.001 (per property extraction)
• Property Data Extracted: $0.002 (per successful property)

Total Cost Per Property: $0.0034 + one-time $0.002 setup fee

Example Cost Calculations:

• 10 properties = $0.002 + (10 × $0.0034) = $0.036
• 100 properties = $0.002 + (100 × $0.0034) = $0.342
• 500 properties = $0.002 + (500 × $0.0034) = $1.702
• 1000 properties = $0.002 + (1000 × $0.0034) = $3.402

💡 Cost-Effective: The setup fee becomes negligible for bulk operations, making this significantly cheaper than manual data collection or premium real estate APIs.

---

🚀 Use Cases

• 🏢 Real Estate Agencies: Bulk market analysis and competitor research
• 📈 Property Investors: Track market trends across multiple regions
• 🔍 SEO & Content Teams: Gather property data for content creation
• 🤖 Developers: Build automated property monitoring systems
• 📊 Market Analysts: Extract insights from large property datasets
• 🏗️ Construction Companies: Identify development opportunities

---

⚡ Key Features

Unlimited Extraction Capability

• Breaks Through Idealista's 60-Page Limit: While Idealista typically limits users to 60 pages (≈1,800 properties) and shows the message "Have you seen 1,800 homes and still can't find what you're looking for?", this actor can extract ALL available properties
• No Artificial Limits: Extract thousands of properties from a single search URL
• Continuous Navigation: Uses internal property navigation to bypass page limitations
• Only Limited by Credits & Time: As long as you have sufficient Apify credits, the actor will continue extracting

🚀 Breakthrough Feature: Most scrapers hit Idealista's 1,800-property wall, but this actor navigates property-by-property, completely bypassing pagination limits!

Resume Capability

• Automatically saves progress during execution
• Resumes from the last processed property if interrupted
• Perfect for large-scale scraping operations

Smart Error Handling

• Exponential backoff for failed requests
• Skips invalid properties automatically
• Comprehensive logging for debugging

Rate Limiting

• Configurable delays between requests
• Respects server resources
• Reduces risk of being blocked

Multi-Domain Support

• Spain: idealista.com
• Portugal: idealista.pt
• Italy: idealista.it

---

📚 Technical Requirements

Proxy Configuration

Residential proxies are required for reliable operation:

"proxyConfig": {
  "useApifyProxy": true,
  "apifyProxyGroups": ["RESIDENTIAL"]
}

Input Validation

• Only Idealista domains are accepted
• URLs must be properly formatted search result pages
• Invalid URLs are automatically skipped

---

⚖️ Legal & Ethical Considerations

This actor:

• ✅ Respects robots.txt directives
• ✅ Implements appropriate rate limiting
• ✅ Only extracts publicly available data
• ✅ Does not bypass paywalls or authentication

---

🔧 Advanced Configuration

For Unlimited Large-Scale Extraction

{
  "desiredResults": 0,
  "delayBetweenRequests": 1000,
  "maxRetries": 5,
  "retryDelay": 1000
}

💡 Set desiredResults: 0 to extract ALL properties available, breaking through Idealista's typical 1,800-property limit. Ensure you have sufficient credits for large extractions.

For Quick Testing

{
  "desiredResults": 10,
  "delayBetweenRequests": 500,
  "maxRetries": 2,
  "retryDelay": 500
}

Important Notes for Large Extractions:

• Credit Requirements: Large-scale extractions (5,000+ properties) may cost $17+ in credits
• Time Investment: Extracting 10,000 properties may take several hours due to rate limiting
• Monitor Progress: Use Apify's dashboard to track extraction progress
• Resume Feature: If interrupted, the actor will automatically continue from the last processed property

---

🤝 Support & Contact

For assistance, custom implementations, or bulk processing needs:

• 📧 Email: fridaytechnolog@gmail.com
• 🐙 GitHub: DZ-ABDLHAKIM
• 🐦 Twitter: @DZ_45Omar
• 🔧 Apify: dz_omar

---

📝 Version History

• v1.0: Initial release with bulk scraping capabilities
• Built on top of the proven Idealista Scraper API

---