🏠 Idealista Portugal Scraper

This Apify actor scrapes property listings from Idealista Portugal using advanced anti-detection technology. Ideal for real estate market research, property investment analysis, or anyone needing structured data about properties in Portugal.

✨ 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
  • Number of bedrooms and size
  • Price per square meter
  • Seller information
  • Property descriptions

🚀 Usage

Required Input Parameters

Parameter	Type	Description	Required	Options
language	String	Language for the website interface	✅ Yes	"pt", "en", "fr", "es"
district	String	District to search for properties	✅ Yes	Any Portuguese district
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 specific criteria	✅ Yes	See options below

Optional Input Parameters

Parameter	Type	Description	Required	Options
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

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

Sorting Options

• Relevance: Default sorting (no specific order)
• Lowest price: Sort by price ascending
• Highest price: Sort by price descending
• Most recent: Sort by publication date descending
• Oldest: Sort by publication date ascending
• Price Reduction: Sort by price reductions descending

Example Input

{
  "language": "en",
  "district": "lisboa",
  "rent_or_buy": "buy",
  "type_of_property": "Homes",
  "max_price": 300000,
  "min_price": 50000,
  "min_area": 50,
  "sort_by": "Most recent"
}

📊 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_link: Direct link to the property listing
• property_address: Property address/location.
• property_district: District where the property is located
• property_type: Type of property (e.g., "Homes", "Commercial properties")

Pricing Information

• property_price: Property price in euros (float)
• price_reduction: Property price reduction (float)
• price_square_meter: Price per square meter in euros (float)

Property Details

• number_of_bedrooms: Number of bedrooms (e.g., "T2", "T3")
• 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": "Apartment in Bairro Alto, Misericórdia",
  "property_link": "https://www.idealista.pt/en/imovel/29391382/",
  "property_address": "Bairro Alto, Misericórdia",
  "property_type": "Homes",
  "property_district": "lisboa",
  "property_price": 280000.0,
  "property_description": "Beautiful apartment with 47 sqm, inserted in the new project Luz Soriano Palace, in the middle of Bairro Alto. The building, of classical design, completely renovated by recognized architectonic office, now assumes a modern, exclusive character.",
  "seller": "Engel & Völkers Lisboa",
  "number_of_bedrooms": "T2",
  "size": 47.0,
  "price_square_meter": 5957.0,
  "more_info": "2nd floor | Good condition"
}

⚠️ Limitations

• Page Limit: The scraper is limited to up to 10 pages per run. If you need more results, adjust your filters (price range, area, etc.) to get fewer results per page.
• District-level Search: Only supports searching by Portuguese districts (e.g., "lisboa", "porto", "faro"). Cannot search by specific municipalities or counties.
• Dynamic Content: Idealista may change their website structure, which could affect the scraper's functionality.