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: json { "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: json { "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 json { "search_params": { "location": "porto", "operation": "venda", "max_pages": 3 } } ### Advanced Filtering json { "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.