🏠 Idealista Spain Scraper (Per Event) Scrape property listings from Idealista Spain in English, French, Spanish and Portuguese. Ideal for real estate market research, property investment analysis, or anyone needing structured data about properties in Spain. This actor uses a per-event pricing model, charging only for what you use. ## ✨ Features - Multi-language Support: Portuguese, English, French, Spanish interfaces - Comprehensive Property Types: Homes, Commercial, Garages, Land, Storage rooms, Buildings, New homes - Extracts Complete Property Data: - Property details and pricing - Property images - Number of bedrooms and size - Price per square meter (calculated if not provided) - Seller information - Property descriptions - Location and district information ## 💰 Pricing (Per Event) This actor uses a per-event pricing model: - Actor Start: $0.10 per actor run - Proxy Rotation: $0.10 per proxy rotation - Result: $0.01 per property result scraped ### Example Cost Calculation For a run that scrapes 100 properties with 2 proxy rotations: - Actor start: $0.10 - Proxy rotations (2 × $0.10): $0.20 - Results (100 × $0.01): $1 - Total: $1.30 ## 🚀 Usage ### Required Input Parameters | Parameter | Type | Description | Required | Options | | ------------------ | ------- | ----------------------------------------------- | -------- | ----------------------- | | search_term | String | Location to search for properties (city, province, etc.) | ✅ Yes | Any Spanish location | | rent_or_buy | String | Whether to search for properties to rent or buy | ✅ Yes | "buy", "rent" | | type_of_property | String | Type of property to search for | ✅ Yes | See options below | | sort_by | String | Sort results by | ✅ Yes | See options below | ### Optional Input Parameters | Parameter | Type | Description | Required | Options | | ------------------ | ------- | ----------------------------------------------- | -------- | ----------------------- | | language | String | Language for the website interface | ❌ No | "pt", "en", "fr", "es" | | max_price | Integer | Maximum price filter in euros | ❌ No | Any positive number | | min_price | Integer | Minimum price filter in euros | ❌ No | Any positive number | | min_area | Integer | Minimum area filter in square meters | ❌ No | Any positive number | | max_properties | Integer | Maximum number of properties to scrape | ❌ No | Any positive number | ### Sort Options - Relevance: Default sorting - Lowest price: Sort by price ascending - Highest price: Sort by price descending - Most recent: Sort by most recently updated - Oldest: Sort by oldest listings - Price Reduction: Sort by properties with price reductions ### Property Types Available - New homes: New construction projects - Homes: Houses and apartments - Commercial properties: Shops and warehouses - Garages: Parking spaces - Land: Plots of land - Storage rooms: Storage units - Buildings: Entire buildings ### Example Input json { "language": "en", "search_term": "Aracena", "rent_or_buy": "buy", "type_of_property": "Homes", "max_price": 100000, "sort_by": "Lowest price", "max_properties": 50 } ## 📊 Output The actor stores results in the default dataset, with each property represented as a JSON object containing: ### Core Property Information - property_title: Title/name of the property - property_id: Unique property identifier - property_image: URL to the property's main image - property_link: Direct link to the property listing - property_address: Property address (extracted from title) - property_location: Location where the property is located - property_district: District/area within the location - property_type: Type of property (e.g., "Homes", "Commercial properties") ### Pricing Information - property_price: Property price in euros (float) - price_reduction: Price reduction percentage (float, e.g., 0.05 for 5%) - price_square_meter: Price per square meter in euros (float, calculated if not provided) ### Property Details - number_of_bedrooms: Number of bedrooms (integer, e.g., 1, 2, 3) - size: Property size in square meters (float) - more_info: Additional property details (string) ### Additional Information - property_description: Full property description - seller: Seller/agency information ### Example Output json { "property_title": "Flat / apartment in Aracena", "property_image": "https://img4.idealista.com/blur/480_360_mq/0/id.pro.es.image.master/08/e5/84/1366217828.jpg", "property_id": "109147780", "property_link": "https://www.idealista.com/en/inmueble/109147780/", "property_address": "Aracena", "property_location": "Aracena", "property_district": "Huelva", "property_type": "Homes", "property_price": 65000.0, "price_reduction": null, "property_description": "\nCentrally located 50 m2 apartment on the third floor (no elevator), located in one of the most convenient and practical areas of Aracena (Huelva).\nThe property features a functional layout that makes the most of every space:\nA bright living room ideal for creating a relaxation and dining area, a fully equipped kitchen,\n", "seller": "Serraneando", "number_of_bedrooms": 1, "size": 50.0, "price_square_meter": 1300.0, "more_info": "without lift" } ## ⚠️ Limitations - Page Limit: The scraper is limited to up to 12 pages per run to prevent timeouts. If you need more results, adjust your filters (price range, area, etc.) to get fewer results per page. - Max Properties: Use the max_properties parameter to limit the number of properties scraped. The scraper will stop once it reaches this limit, even if more pages are available.