🏘️ 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 Property 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 Idealista Property Scraper 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:

{
  "MainImage": "https://img4.idealista.com/blur/WEB_DETAIL_TOP-L-L/0/id.pro.es.image.master/52/48/b2/1314359991.jpg",
  "title": "Flat / apartment for sale in Calle Barrinou",
  "price": "39000 €",
  "location": "Balaguer",
  "description": "This comment was automatically translated and may not be 100% accurate. See description in the original language Local to reform in Balaguer. It has an area of 60 m2.",
  "characteristics": [
    "59 m² built",
    "2 bedrooms",
    "1 bathroom",
    "Second hand/good condition"
  ],
  "contactInfo.phones": "+34 965 02 32 90",
  "mapImagePath": "https://api.apify.com/v2/key-value-stores/L9wbNlkhaeaKs7kfD/records/105296229.jpg",
  "Url": "https://www.idealista.com/en/inmueble/105296229/",
  "updatedAt": "Listing updated more than 2 months ago",
  "scrapedAt": "2025-08-09T05:02:30.463Z"
}

---

💰 Pricing Model - Monthly Subscription + Idealista Property Scraper API Costs

🎯 Monthly Subscription: $4.99/month + Idealista Property Scraper API costs per property

This actor operates with a monthly rental subscription plus charges for the internal Idealista Property Scraper API calls. Here's the complete pricing breakdown:

Pricing Structure:

• Monthly Rental: $4.99/month (auto-renewing subscription)
• Idealista Property Scraper API Costs: Variable pricing based on your Apify subscription tier
• 3-Day Free Trial: Test the actor before committing to subscription

Idealista Property Scraper API Costs (Per Property):

Your Apify Subscription	Initialization	Data Extraction	Total per Property
No Subscription	$0.005	$0.008	$0.013
Bronze	$0.001	$0.002	$0.003
Silver	$0.00001	$0.0015	$0.00151
Gold	$0.00001	$0.0015	$0.00151

Total Monthly Cost Examples:

Without Apify Subscription:

Properties	Monthly Subscription	API Costs	Total Monthly Cost
100 properties	$4.99	100 × $0.013 = $1.30	$6.29
500 properties	$4.99	500 × $0.013 = $6.50	$11.49
1,000 properties	$4.99	1,000 × $0.013 = $13.00	$17.99

With Bronze Apify Subscription:

Properties	Monthly Subscription	API Costs	Total Monthly Cost
100 properties	$4.99	100 × $0.003 = $0.30	$5.29
500 properties	$4.99	500 × $0.003 = $1.50	$6.49
1,000 properties	$4.99	1,000 × $0.003 = $3.00	$7.99

With Silver/Gold Apify Subscription:

Properties	Monthly Subscription	API Costs	Total Monthly Cost
100 properties	$4.99	100 × $0.00151 = $0.15	$5.14
500 properties	$4.99	500 × $0.00151 = $0.76	$5.75
1,000 properties	$4.99	1,000 × $0.00151 = $1.51	$6.50
10,000 properties	$4.99	10,000 × $0.00151 = $15.10	$20.09

💡 Cost Optimization Recommendations:

🥈 Upgrade to Silver/Gold for Maximum Savings:

• For 1,000 properties: Save $11.49 monthly vs no subscription
• For 10,000 properties: Save $94.91 monthly vs no subscription
• ROI: Silver/Gold subscription pays for itself with just 500+ properties monthly

Cost Formula:

Monthly Total = $4.99 + (Number of Properties × API Cost per Property)

Additional Platform Costs:

You'll still pay standard Apify platform costs for:

• Compute Units: For running the bulk scraper
• Storage: For storing extracted data
• Residential Proxies: Already included in Apify proxy costs

---

🚀 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 Your Subscription: Extract properties with active subscription (API costs apply per property)

🚀 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.

For Quick Testing

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

Important Notes for Large Extractions:

• Subscription Required: Active $4.99/month subscription needed
• Apify Subscription Recommended: Upgrade to Silver/Gold for massive API cost savings
• Platform Costs: Additional platform usage costs apply
• 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

---

🎯 Getting Started

1. Start Free Trial: Activate the 3-day free trial
2. Consider Apify Subscription: Upgrade to Silver/Gold for 88% API cost savings
3. Test the Actor: Run small extractions to verify functionality
4. Subscribe: Convert to monthly subscription for unlimited access
5. Scale Up: Extract thousands of properties with confidence

Subscription Management

• Auto-Renewal: Monthly subscription automatically renews
• Cancel Anytime: Cancel subscription in Apify Console
• Immediate Access: Start extracting immediately after subscription

---

🤝 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

Version 1.0 (Current)

• ✅ Updated to use Idealista Property Scraper API v2.0 with tiered pricing
• ✅ Enhanced cost optimization based on Apify subscription levels
• ✅ Advanced anti-bot detection bypass through updated API integration
• ✅ Improved performance and reliability
• ✅ Updated documentation with new pricing structure
• ✅ Resume capability for large extractions
• ✅ Unlimited property extraction (bypasses 1,800-property limit)

Previous Versions

• v0.3: Initial release with bulk scraping capabilities
• Built on top of the proven Idealista Property Scraper API

---