Idealista Property Scraper An Apify actor for scraping real estate listings from Idealista.com, Spain's leading real estate platform. This scraper extracts detailed property information including prices, features, locations, and more. ## 🚀 Features - Scrapes property listings from Idealista.com - Extracts comprehensive property details: - Basic information (price, size, rooms, bathrooms) - Location details (address, neighborhood, city, province) - Property features and amenities - Images and descriptions - Energy certification - Contact information - Handles pagination automatically - Respects website's robots.txt and implements polite scraping - Stores results in structured format - Supports various search filters ## 📋 Input Parameters The actor accepts the following input parameters: json { "country": "es", "locationName": "Callosa de Segura, Alicante", "distance": 0, "locationId": "0-EU-ES-03-05-015-049", "propertyType": "homes", "sort": "desc", "operation": "sale", "order": "weigh", "locale": "en", "quality": "high", "gallery": true, "maxItems": 30, "numPage": 1 } | Parameter | Type | Description | Default | |-----------|------|-------------|---------| | country | String | Country code to search in (es: Spain, it: Italy, pt: Portugal) | es | | locationName | String | Name of the location to search in | Callosa de Segura, Alicante | | locationId | String | Idealista location ID | 0-EU-ES-03-05-015-049 | | propertyType | String | Type of property to search for:
- newDevelopments: New Developments
- homes: Homes
- offices: Offices
- premises: Commercial Property
- transfers: Transfers
- garages: Garages
- lands: Land
- storageRooms: Storage Rooms
- buildings: Buildings | homes | | sort | String | Sort direction for results (asc/desc) | desc | | operation | String | Type of operation (sale/rent) | sale | | order | String | Field to order results by:
- weigh: Relevance
- price: Price
- publicationDate: Publication Date
- priceDown: Price Reduction
- ratioeurm2: Price per m²
- size: Size | weigh | | locale | String | Language for results (en/es/it/pt) | en | | quality | String | Quality of images (high/medium/low) | high | | gallery | Boolean | Whether to include image gallery | true | | maxItems | Integer | Maximum number of items per page (1-50) | 30 | | numPage | Integer | Page number to start scraping from | 1 | Required Parameters: - country - propertyType - operation - locationName - locationId Note: For locationName ane locationId , use actor Idealista Location Scraper Note: The actor uses Apify's proxy infrastructure by default to avoid IP-based blocking. You don't need to configure proxy settings manually. ## 📊 Output Dataset The actor stores results in a dataset with the following schema: json { "propertyCode": "String - Unique property identifier", "url": "String - Property listing URL", "thumbnail": "String - Main property image URL", "numPhotos": "Number - Total number of photos", "price": "Number - Property price in euros", "priceInfo": { "price": { "amount": "Number - Price amount", "currencySuffix": "String - Currency symbol", "priceDropInfo": { "formerPrice": "Number - Previous price", "priceDropValue": "Number - Price reduction amount", "priceDropPercentage": "Number - Percentage of price reduction" } } }, "propertyType": "String - Type of property (e.g., countryHouse)", "operation": "String - Sale or rent", "size": "Number - Size in square meters", "rooms": "Number - Number of rooms", "bathrooms": "Number - Number of bathrooms", "address": "String - Street address", "province": "String - Province name", "municipality": "String - Municipality name", "country": "String - Country code", "locationId": "String - Idealista location identifier", "latitude": "Number - Geographic latitude", "longitude": "Number - Geographic longitude", "description": "String - Full property description", "multimedia": { "images": [ { "url": "String - Image URL", "tag": "String - Image type (e.g., bedroom, bathroom, livingRoom)" } ] }, "contactInfo": { "phone1": { "phoneNumber": "String - Contact phone number", "formattedPhone": "String - Formatted phone number", "prefix": "String - Country prefix", "phoneNumberForMobileDialing": "String - Full international number", "nationalNumber": "Boolean - Is national number" }, "contactName": "String - Contact person name", "userType": "String - Type of seller (private/professional)", "contactMethod": "String - Preferred contact method" }, "features": { "hasSwimmingPool": "Boolean - Has swimming pool", "hasTerrace": "Boolean - Has terrace", "hasAirConditioning": "Boolean - Has air conditioning", "hasBoxRoom": "Boolean - Has storage room", "hasGarden": "Boolean - Has garden" }, "parkingSpace": { "hasParkingSpace": "Boolean - Has parking", "isParkingSpaceIncludedInPrice": "Boolean - Parking included in price" }, "priceByArea": "Number - Price per square meter", "detailedType": { "typology": "String - Main property type", "subTypology": "String - Specific property type" }, "status": "String - Property condition", "hasVideo": "Boolean - Has video tour", "has3DTour": "Boolean - Has 3D tour", "has360": "Boolean - Has 360° view", "labels": [ { "name": "String - Label identifier", "text": "String - Label display text" } ] } Note: Some fields may be null or missing depending on the property listing. The schema above represents all possible fields that can be returned by the scraper. Key features of the output: - Detailed price information including price history - Comprehensive property features and amenities - Complete multimedia content (images with tags) - Precise location data including coordinates - Contact information for the seller - Property status and special features (video, 3D tour, etc.) ## Pagination and Search Results - Apply your search parameters to search, and get the first page (numPage = 1) - Check the total number of results from the key-value store - Increment numPage to 2, and maintain the same search parameters - Continue this process until you have retrieved all available results