LuxuryEstate Real Estate Scraper

Scrape LuxuryEstate.com — a global luxury property portal listing villas, penthouses, mansions, castles, country houses and more across 90+ countries. Browse listings for sale or rent by country, region/city, and property type, or pull full listing details (price, size, amenities, agency contact, images, video) for specific property URLs. No login, no API key, no proxy required.

What this actor does

• Two modes: browse (search by country/region/property type/transaction, or by a specific agency) and propertyDetails (fetch full data for specific listing URLs)
• Browse by agency — set agencyUrl to pull a real estate agency's entire LuxuryEstate.com portfolio instead of browsing by geography
• 90+ countries across Europe, the Americas, Africa, the Middle East, Asia-Pacific, and the Caribbean
• 15 property types: apartments, penthouses, villas, mansions, castles, lands, and more
• Sale or rent transaction filter
• Sort order: relevance, price (low↔high), size (small↔large), most bedrooms, most rooms
• Display currency: view (and filter) prices in EUR, USD, GBP, CHF, AED, JPY, CNY, AUD, CAD, HKD, RUB, BRL, TRY, PLN, ILS or KRW — the source site's own live FX conversion
• Numeric filters: minimum/maximum price, minimum bedrooms, minimum bathrooms, minimum/maximum floor size
• Amenity filters: require any combination of 34 interior/exterior amenities (pool, garden, fireplace, elevator, waterfront, skylight, pond, etc.), plus dedicated garden/parking/balcony/terrace toggles
• Cooling system filter: restrict to listings with air conditioning or a ceiling fan
• Rich per-listing data: price, currency, size, bedrooms/bathrooms, amenities, coordinates, agency contact, images
• Diacritic-tolerant location matching — accented region/city names (e.g. île-de-france) resolve automatically
• Empty fields are omitted — every record only contains data that was actually found

Output per property

Browse mode (recordType: "propertyListing")

• propertyId, title, propertyType, transaction (sale/rent)
• price (numeric), priceFormatted, currency
• sizeSqm (internal floor area), plotSizeSqm (land/plot area)
• bedrooms, bathrooms, rooms
• country, region, province, city
• latitude, longitude
• imageUrl
• agencyName, agencyUrl, agencyLogoUrl
• reference — the listing agency's own reference code
• datePosted
• amenities[] — e.g. pool, garden, fireplace, elevator
• heating[] — heating system type(s), e.g. heat_pump, forced_air, when reported
• buildYear, videoUrl, virtualTourUrl, floorPlanUrl — when the listing provides them
• exteriorMaterial[], roofMaterial[], floorMaterial[] — construction materials (e.g. stucco, brick, tile, hardwood), when reported
• lastUpdated — when the agency last edited the listing
• listingTier — the agency's paid promotion tier for this listing (elite/prestige/premium/collection/standard); higher tiers rank first under relevance sort
• floorNumber — the unit's floor (0 = ground floor), when reported
• gardenType[] — garden type(s), e.g. private, common, when the listing has one
• externalListingUrl — the listing's page on a partner MLS/portal (e.g. Sotheby's International Realty), when the listing was syndicated from one
• propertyUrl, sourceUrl
• scrapedAt

Property details mode (recordType: "propertyDetail")

All of the above (except province and listingTier, which are browse-only), plus:

• description — full listing description
• parkingIndoor, parkingOutdoor
• images[] — up to 30 full-resolution photo URLs
• floorPlanImages[], floorPlanUrl — floor-plan diagrams, when the agency uploaded any
• viewCount, likeCount — the listing's page-view and favorite counters on LuxuryEstate.com
• cooling[] — cooling system type(s), e.g. air_conditioning, ceiling_fan, when reported
• agencyPhone, agencyMobile, agencyEmail, agencyLocation
• address — street address, when the listing agency made it public
• postalCode — postal/ZIP code (shown even when the full street address is withheld)
• energyClass — EU-style energy performance rating (e.g. A+, B, G), when provided
• view[] — view tags reported by the listing, e.g. lake, mountains, city
• totalFloors — the building's total floor count
• kitchenType, kitchenCount — kitchen layout (e.g. kitchendiner, kitchenette) and count, when reported
• balconyCount or hasBalcony — number of balconies when specified, otherwise a simple presence flag
• terraceSizeSqm or hasTerrace — terrace floor area when specified, otherwise a simple presence flag

Input

Field	Type	Default	Description
mode	string	browse	browse / propertyDetails
country	select	italy	Country to browse (mode=browse)
location	string	–	Optional region/city slug within the country, e.g. lake-garda. Ignored if agencyUrl is set
agencyUrl	string	–	Browse one agency's full inventory instead of by geography, e.g. https://www.luxuryestate.com/a12123945-the-dream-real-estate-srl (from any record's agencyUrl field). Overrides country/location/propertyType/transaction when set
propertyType	select	any	Restrict to one property type
transaction	select	sale	sale or rent
sortBy	select	relevance	relevance / price-asc / price-desc / size-asc / size-desc / bedrooms-desc / rooms-desc
displayCurrency	select	EUR	Currency for price/priceFormatted — EUR/USD/GBP/CHF/AED/JPY/CNY/AUD/CAD/HKD/RUB/BRL/TRY/PLN/ILS/KRW
minPrice / maxPrice	int	–	Price range filter, interpreted in displayCurrency
minBedrooms / minBathrooms	int	–	Minimum bedroom/bathroom count
minSizeSqm / maxSizeSqm	int	–	Internal floor area range (m²)
amenities	array	–	Only return listings with ALL selected amenities, e.g. pool, garden, elevator, fireplace, waterfront (mode=browse)
withGarden	boolean	false	Only listings with a garden (mode=browse)
withParking	boolean	false	Only listings with parking (mode=browse)
withBalcony	boolean	false	Only listings with a balcony (mode=browse)
withTerrace	boolean	false	Only listings with a terrace (mode=browse)
coolingType	select	any	Restrict to listings with air_conditioning or ceiling_fan (mode=browse)
startPage	int	1	First results page to fetch (15 listings/page)
propertyUrls	array	–	Full listing URLs (mode=propertyDetails)
maxItems	int	30	Hard cap on emitted records (1–1000)

Example: villas for sale in Lake Garda, Italy, 3+ bedrooms

{
  "mode": "browse",
  "country": "italy",
  "location": "lake-garda",
  "propertyType": "villas",
  "transaction": "sale",
  "minBedrooms": 3,
  "maxItems": 30
}

Example: apartments for rent in Monaco under €10,000

{
  "mode": "browse",
  "country": "monaco",
  "propertyType": "apartments",
  "transaction": "rent",
  "maxPrice": 10000,
  "maxItems": 20
}

Example: waterfront houses with a pool and garden in the US

{
  "mode": "browse",
  "country": "united-states",
  "propertyType": "houses",
  "amenities": ["pool", "garden", "waterfront"],
  "withParking": true,
  "maxItems": 20
}

Example: US houses priced in US dollars

{
  "mode": "browse",
  "country": "united-states",
  "propertyType": "houses",
  "displayCurrency": "USD",
  "minPrice": 1000000,
  "maxItems": 20
}

Example: every listing from one agency, most expensive first

{
  "mode": "browse",
  "agencyUrl": "https://www.luxuryestate.com/a12123945-the-dream-real-estate-srl",
  "sortBy": "price-desc",
  "maxItems": 50
}

Example: full details for specific listings

{
  "mode": "propertyDetails",
  "propertyUrls": [
    "https://www.luxuryestate.com/p132776660-villa-for-sale-javea"
  ]
}

Use cases

• Real estate market research — track luxury property pricing across countries and regions
• Investment analysis — filter by price, size and bedroom count to shortlist opportunities
• Relocation & lifestyle platforms — surface luxury inventory for a destination
• Lead generation — pull agency contact details for outreach
• Portfolio monitoring — periodically re-fetch specific listing URLs to track price/status changes

FAQ

What is LuxuryEstate.com? A global luxury real estate marketplace aggregating listings from real estate agencies in 90+ countries, covering villas, penthouses, mansions, castles, country estates and more.

Do I need a proxy or login? No. The actor talks to LuxuryEstate.com directly over plain HTTPS — no proxy, no account, and no API key are required.

How many listings are returned per page? LuxuryEstate shows 15 listings per browse page; the actor paginates automatically up to maxItems.

How do I find a region/city slug for the location field? Browse luxuryestate.com in your browser, navigate to the region or city page you want, and copy everything in the URL path after the country. Some destinations are one segment (https://www.luxuryestate.com/italy/lake-garda → lake-garda), others need the full hierarchy (https://www.luxuryestate.com/france/ile-de-france/paris/paris → ile-de-france/paris/paris).

Why are some fields missing on some records? The actor only includes fields the source actually provides for that listing — for example, not every listing has a build year or virtual tour, so those fields are simply omitted rather than showing empty placeholders.

What currency are prices in? By default, all prices are shown in EUR (the source site's own default display currency), regardless of the listing's country — set displayCurrency to convert every price on the run to USD, GBP, CHF, AED, JPY, CNY, AUD, CAD, HKD, RUB, BRL, TRY, PLN, ILS or KRW instead. minPrice/maxPrice are interpreted in whatever displayCurrency you chose. See the currency field on each record to confirm which currency was used.

Can I filter by amenities? Yes — set amenities to any combination of pool, garden, fireplace, elevator, waterfront, sauna and 28 other codes (a listing must have ALL selected amenities), or use the dedicated withGarden/withParking/withBalcony/withTerrace toggles for those four common features.

Can I sort results? Yes — set sortBy to price-asc/price-desc for cheapest/most expensive first, size-asc/size-desc for smallest/largest first, or bedrooms-desc/rooms-desc for the biggest homes first. Default is relevance (the source site's own ranking).

Can I filter by cooling system? Yes — set coolingType to air_conditioning or ceiling_fan (mode=browse) to only return listings with that cooling system. Leave as the default any to skip this filter.

Can I get every listing from one agency? Yes — set agencyUrl to the agency's own LuxuryEstate.com page URL (found on the agencyUrl field of any browse/detail record, or by browsing the site directly). This returns that agency's entire portfolio instead of a geography-based search; country/location/propertyType/transaction are ignored, but price/size/bedroom/bathroom/amenity filters, sorting and currency still apply.

Does location need to be typed exactly? Accented characters are normalized automatically (e.g. île-de-france and ile-de-france both work), and casing/spacing is normalized too. If the location still can't be resolved to a valid path, the actor logs a warning and falls back to browsing the whole country rather than failing the run.