🏠 Idealista Portugal Scraper

Scrape property listings from Idealista Portugal in English, French, Spanish and Portuguese. 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"
search_term	String	Location/area to search for properties	✅ Yes	Any Portuguese 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 specific criteria	✅ Yes	See sorting 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",
  "search_term": "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_image: URL to the property's main image
• property_id: Unique identifier for the property
• property_address: Property address/location (extracted from title)
• property_location: Specific location/area within the district
• 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
• price_reduction: Property price reduction
• price_square_meter: Price per square meter in euros

Property Details

• number_of_bedrooms: Number of bedrooms (e.g., "T2", "T3")
• size: Property size in square meters
• more_info: Additional property details (string)

Additional Information

• property_description: Full property description
• seller: Seller/agency information

Example Output

{
  "property_title": "Detached house in Odeleite, Castro Marim",
  "property_image": "https://img4.idealista.pt/blur/480_360_mq/0/id.pro.pt.image.master/29/5c/16/293542742.jpg",
  "property_id": "34423278",
  "property_link": "https://www.idealista.pt/en/imovel/34423278/",
  "property_address": "Odeleite, Castro Marim",
  "property_location": "Castro Marim",
  "property_district": "Faro",
  "property_type": "Homes",
  "property_price": 249000.0,
  "price_reduction": null,
  "property_description": "\nThree-bedroom village house with an annex in Casa Branca - Castro Marim, Algarve.\nCharming, fully restored country house combining modern comforts with rustic heritage - with original wooden beams, wooden floors, a traditional fireplace, antique plow, and cowbells. Includes a separate annex with one bedroom.\nThe quie\n",
  "seller": "Casas do Sotavento",
  "number_of_bedrooms": "T3",
  "size": 89.0,
  "price_square_meter": 2797.75,
  "more_info": null
}

⚠️ Limitations

• Page Limit: The scraper is limited to up to 20 pages per run. If you need more results, adjust your filters (price range, area, etc.).