Idealista Portugal Property Scraper

Extract comprehensive property listings from Idealista Portugal, the leading real estate platform in Portugal. This robust scraper is specifically designed to handle Idealista's advanced anti-bot protection systems and geographic restrictions.

What does this actor do?

This actor scrapes property listings from Idealista Portugal and extracts detailed information including:

• Property Details: Title, description, price, location, size
• Property Features: Number of bedrooms, bathrooms, property type
• Additional Info: Raw property details and HTML for further processing
• Metadata: Unique listing ID, URL, and scraping timestamp

Why use this actor?

• ✅ Geographic Compliance: Uses Portuguese residential proxies to bypass geographic restrictions
• ✅ Anti-Bot Protection: Implements realistic browser headers and intelligent rate limiting
• ✅ Reliable Data: Structured output with data validation using Pydantic models
• ✅ Production Ready: Includes proper error handling and retry mechanisms
• ✅ Easy Integration: Clean JSON output format for seamless data processing

Input Configuration

The actor accepts the following input parameters:

{
  "search_params": {
    "location": "lisboa",
    "operation": "venda",
    "property_type": "apartamento",
    "min_price": 100000,
    "max_price": 500000,
    "max_pages": 5
  },
  "webhook_url": "https://your-service.com/webhook",
  "api_endpoint": "https://your-service.com/api"
}

Input Parameters

Parameter	Type	Required	Description
search_params.location	String	Yes	Location to search (e.g., "lisboa", "porto")
search_params.operation	String	Yes	Operation type: "venda" (sale) or "arrendamento" (rent)
search_params.property_type	String	No	Property type filter
search_params.min_price	Number	No	Minimum price filter
search_params.max_price	Number	No	Maximum price filter
search_params.max_pages	Number	No	Maximum pages to scrape (default: 10)
webhook_url	String	No	Webhook URL for real-time data delivery
api_endpoint	String	No	API endpoint for direct data integration

Output

The actor outputs an array of property listings with the following structure:

{
  "listing_id": "12345678",
  "url": "https://www.idealista.pt/imovel/12345678/",
  "title": "T3 apartment in Lisbon center",
  "price_text": "€ 450.000",
  "description": "Beautiful apartment with balcony...",
  "location": "Avenidas Novas, Lisboa",
  "details_text": "3 hab, 2 baños, 120 m²",
  "scraped_at": "2024-01-15T10:30:00Z",
  "raw_html": "<div class='listing-details'>...</div>"
}

Output Fields

Field	Type	Description
listing_id	String	Unique identifier from Idealista
url	String	Full URL to the property listing
title	String	Property title/headline
price_text	String	Raw price text as displayed on Idealista
description	String	Full property description
location	String	Property location information
details_text	String	Raw property details (rooms, bathrooms, size)
scraped_at	String	ISO timestamp when listing was scraped
raw_html	String	Raw HTML snippet for debugging purposes

Use Cases

This actor is perfect for:

• Real Estate Market Analysis: Track pricing trends and market conditions
• Investment Research: Identify property investment opportunities
• Competitive Analysis: Monitor competitor pricing and inventory
• Lead Generation: Find properties matching specific criteria
• Market Reports: Generate comprehensive market insights

Example Usage

Basic Property Search

{
  "search_params": {
    "location": "porto",
    "operation": "venda",
    "max_pages": 3
  }
}

Advanced Filtering

{
  "search_params": {
    "location": "cascais",
    "operation": "arrendamento",
    "property_type": "apartamento",
    "min_price": 800,
    "max_price": 2000,
    "max_pages": 5
  },
  "webhook_url": "https://myapp.com/idealista-webhook"
}

Important Notes

• Portugal Focus: This actor is optimized specifically for Idealista Portugal
• Proxy Requirements: Uses Portuguese residential proxies for geographic compliance
• Terms of Service: Respects Idealista's terms of service with appropriate rate limiting
• Anti-Bot Protection: Includes sophisticated measures to avoid detection

Troubleshooting

Common Issues:

1. 403 Forbidden Errors: Usually indicates IP geoblocking. The actor uses Portuguese residential proxies to resolve this.

2. No Results: Check if the location parameter matches Idealista's expected format.

3. Rate Limiting: The actor includes built-in delays, but very high volumes may require adjustment.

Support

For questions, issues, or feature requests, please contact the actor maintainer or create an issue in the actor's repository.

---

Legal Notice: This actor is for educational and research purposes. Users are responsible for complying with Idealista's terms of service and applicable laws when using this tool.