# LuxuryEstate Scraper | Global Luxury Real Estate Listings (`parseforge/luxuryestate-scraper`) Actor Export luxury real estate listings worldwide: price, bedrooms, bathrooms, area, location, agent and images. Paste any LuxuryEstate search URL and pull matching properties. CSV, Excel, JSON or XML for real estate research and lead generation. - **URL**: https://apify.com/parseforge/luxuryestate-scraper.md - **Developed by:** [ParseForge](https://apify.com/parseforge) (community) - **Categories:** Real estate, Travel, E-commerce - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $19.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ![ParseForge Banner](https://github.com/ParseForge/apify-assets/blob/ad35ccc13ddd068b9d6cba33f323962e39aed5b2/banner.jpg?raw=true) ## ๐Ÿ’Ž LuxuryEstate Scraper > ๐Ÿš€ **Export LuxuryEstate global luxury listings in seconds.** 100+ countries, price, photos, beds, baths, area, agency. > ๐Ÿ•’ **Last updated:** 2026-05-25 ยท **๐Ÿ“Š 13 fields** per record ยท **100+ countries** ยท **Premium and elite tier** This actor scrapes high-end residential listings published on [luxuryestate.com](https://www.luxuryestate.com), a global luxury portal covering villas, penthouses, estates and trophy properties from premium agencies worldwide. It walks the public search pages and produces clean structured records. Coverage spans United States, France, Italy, Spain, UK, UAE, Caribbean, Switzerland, Portugal, Mexico and 90+ other countries. | ๐ŸŽฏ Target Audience | ๐Ÿ’ก Primary Use Cases | |---|---| | HNW advisors, brokers, family offices, relocators, market researchers | Luxury comparable benchmarks, lead lists, market dashboards, country comparisons | ### ๐Ÿ“‹ What the LuxuryEstate Scraper does - Walks the paginated search URL you provide - Extracts every property card on each page - Captures price, area, beds, baths, agency, photo, listing URL and tier (elite/premium) > ๐Ÿ’ก **Why it matters:** the luxury market is fragmented across dozens of national portals. LuxuryEstate aggregates them so you can benchmark a Tuscany villa against a Hamptons estate in one query. ### ๐ŸŽฌ Full Demo (_๐Ÿšง Coming soon_) ### โš™๏ธ Input
FieldTypeRequiredDescription
searchUrlstringYesLuxuryEstate search URL (paste after filtering)
maxItemsintegerNoMax records to return. Free tier capped at 10.
```json { "searchUrl": "https://www.luxuryestate.com/united-states", "maxItems": 50 } ```` ```json { "searchUrl": "https://www.luxuryestate.com/france", "maxItems": 200 } ``` > โš ๏ธ **Good to Know:** the source paginates with /page-N. Apply on-site filters first and paste the URL. ### ๐Ÿ“Š Output | Field | Type | Description | |---|---|---| | ๐Ÿ–ผ imageUrl | string | Primary listing photo | | ๐Ÿ“Œ title | string | Listing title | | ๐Ÿ’ฐ price | string | Display price with currency | | ๐Ÿ”— url | string | Direct listing URL | | ๐Ÿ†” id | string | LuxuryEstate property id | | ๐Ÿ“ area | string | Built-up area with unit | | ๐Ÿ› bedrooms | number | Number of bedrooms | | ๐Ÿ› bathrooms | number | Number of bathrooms | | ๐Ÿข location | string | Agency / location | | ๐Ÿ“ description | string | Short description excerpt | | ๐Ÿ–ผ imageCount | number | Photo count on detail page | | ๐Ÿ† tier | string | elite, premium or standard | | ๐Ÿ•’ scrapedAt | string | ISO timestamp | | โŒ error | string | Null on success | Sample record: ```json { "imageUrl": "https://pic.le-cdn.com/thumbs/520x390/.../Property-...131998951.jpg", "title": "Luxury home in Banner Elk, Avery County", "price": "โ‚ฌ 5,601,300", "url": "https://www.luxuryestate.com/p131998951-luxury-home-for-sale-banner-elk", "id": "131998951", "area": "655 mยฒ", "bedrooms": 5, "bathrooms": 7, "imageCount": 94, "tier": "elite", "scrapedAt": "2026-05-25T17:51:47.635Z" } ``` ### โœจ Why choose this Actor - ๐ŸŒ Truly global coverage - ๐Ÿ’Ž Captures elite vs premium tier flag - ๐Ÿ“ Area, beds, baths and image count for analysis - โšก Direct HTML extraction, no headless browser - ๐Ÿ“ฆ CSV, Excel, JSON, XML export ### ๐Ÿ“ˆ How it compares to alternatives | Approach | Coverage | Cost | Freshness | |---|---|---|---| | Manual copy-paste | Tiny | Free, slow | Stale | | National luxury portals | Single country | Free | Live | | This actor | 100+ countries | $ | Live | ### ๐Ÿš€ How to use 1. [Create a free account w/ $5 credit](https://console.apify.com/sign-up?fpr=vmoqkp) 2. Open the LuxuryEstate Scraper on Apify 3. Paste your filtered luxuryestate.com URL 4. Set maxItems 5. Run, then download CSV / Excel / JSON / XML ### ๐Ÿ’ผ Business use cases #### Luxury comparable research | Need | How this helps | |---|---| | Trophy property comps | Filter by country / price band | | Cross-border benchmarks | Aggregate price by area per country | #### HNW lead sourcing | Need | How this helps | |---|---| | Identify active premium agencies | Group by location/agency | | Spot fresh inventory | Schedule daily and diff | #### Market research | Need | How this helps | |---|---| | Track global luxury supply | Run weekly snapshots | | Brand share studies | Count tier=elite per country | #### Family office advisory | Need | How this helps | |---|---| | Curated short-lists | Apply filters and export | | Relocation scouting | Browse multiple geographies in one feed | ### ๐Ÿ”Œ Automating LuxuryEstate Scraper Connect to Make, Zapier, n8n, Slack, Airbyte, GitHub Actions or Google Drive. Trigger on schedule and pipe to your CRM or warehouse. ### ๐ŸŒŸ Beyond business use cases #### Research Academic studies of global luxury real estate flows. #### Personal Build a wishlist of dream homes across continents. #### Non-profit Map ultra-luxury concentration for inequality research. #### Experimentation Train ML pricing models with global luxury inventory. ### ๐Ÿค– Ask an AI assistant about this scraper ChatGPT, Claude, Perplexity and Copilot can suggest workflows around this actor. ### โ“ Frequently Asked Questions **Q1. Do I need a LuxuryEstate account?** No, only the public website is queried. **Q2. Which countries are covered?** Wherever LuxuryEstate lists inventory, 100+ countries. **Q3. What currency is the price in?** Each listing has its own currency, shown verbatim. **Q4. What does tier mean?** Elite and premium are paid placement tiers on the source. Standard listings appear too. **Q5. Are rental listings included?** The source is primarily for-sale. Some markets include rentals. **Q6. How fresh is the data?** Real time, on each run. **Q7. Can I filter by price band?** Apply the on-site filter and paste the URL. **Q8. How many records per page?** Approximately 40-50. **Q9. Are full detail pages scraped?** The listing card payload is captured. For full details, run a second pass on each url. **Q10. Is the data legal to collect?** Only public data, no login bypass. **Q11. Why is bedrooms/bathrooms sometimes null?** The source omits these specs on some listings; preserved as null. ### ๐Ÿ”Œ Integrate with any app Webhooks, REST API, n8n, Make, Zapier, Airbyte, Slack, Discord, GitHub, Google Sheets, Drive, BigQuery, AWS S3 and more. ### ๐Ÿ”— Recommended Actors | Actor | Use case | |---|---| | Royal LePage Canada Scraper | Canadian listings | | Property Finder UAE Scraper | UAE listings | | Apartments.com Scraper | US rentals | > ๐Ÿ’ก **Pro Tip:** browse the complete [ParseForge collection](https://apify.com/parseforge). **๐Ÿ†˜ Need Help?** [Open our contact form](https://tally.so/r/BzdKgA) > **โš ๏ธ Disclaimer:** independent tool, not affiliated with LuxuryEstate. Only publicly available data collected. # Actor input Schema ## `searchUrl` (type: `string`): LuxuryEstate search URL (paste from luxuryestate.com after filtering, e.g. https://www.luxuryestate.com/united-states) ## `maxItems` (type: `integer`): Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000 ## Actor input object example ```json { "searchUrl": "https://www.luxuryestate.com/united-states", "maxItems": 10 } ``` # Actor output Schema ## `results` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "searchUrl": "https://www.luxuryestate.com/united-states", "maxItems": 10 }; // Run the Actor and wait for it to finish const run = await client.actor("parseforge/luxuryestate-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "searchUrl": "https://www.luxuryestate.com/united-states", "maxItems": 10, } # Run the Actor and wait for it to finish run = client.actor("parseforge/luxuryestate-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "searchUrl": "https://www.luxuryestate.com/united-states", "maxItems": 10 }' | apify call parseforge/luxuryestate-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=parseforge/luxuryestate-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "LuxuryEstate Scraper | Global Luxury Real Estate Listings", "description": "Export luxury real estate listings worldwide: price, bedrooms, bathrooms, area, location, agent and images. Paste any LuxuryEstate search URL and pull matching properties. CSV, Excel, JSON or XML for real estate research and lead generation.", "version": "0.1", "x-build-id": "Ka37sv3O2OrQe8dcV" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parseforge~luxuryestate-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parseforge-luxuryestate-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/parseforge~luxuryestate-scraper/runs": { "post": { "operationId": "runs-sync-parseforge-luxuryestate-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/parseforge~luxuryestate-scraper/run-sync": { "post": { "operationId": "run-sync-parseforge-luxuryestate-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "searchUrl": { "title": "Search URL", "type": "string", "description": "LuxuryEstate search URL (paste from luxuryestate.com after filtering, e.g. https://www.luxuryestate.com/united-states)", "default": "https://www.luxuryestate.com/united-states" }, "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000" } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```