🏠 Idealista Spain Scraper

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.

✨ 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

🚀 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

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

{
  "language": "en",
  "search_term": "Aracena",
  "rent_or_buy": "buy",
  "type_of_property": "Homes",
  "max_price": 100000,
  "sort_by": "Lowest price"
}

📊 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

{
  "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.