JamesEdition Real Estate Scraper

Pull luxury property listings from JamesEdition at scale — asking prices in euros and dollars, bedrooms, living and land area, map coordinates, seller descriptions, high-resolution photography, and the listing brokerage behind every property. One marketplace covers Côte d'Azur villas, Alpine chalets, Tuscan estates, Caribbean private islands, and Dubai penthouses in a single, consistent schema. Built for luxury brokerages, property investors, relocation advisors, and PropTech teams who need a structured prime-property dataset without clicking through hundreds of gallery pages by hand.

Why This Scraper?

• 830,000+ luxury listings across 60+ countries — the world's largest prime-property marketplace, from EUR 200,000 apartments to nine-figure estates, in one uniform dataset.
• 54 amenity and setting filters that genuinely stack — combine Pool + Sea view + Helipad + Ski-in / Ski-out and you get properties matching all of them. Cross-referencing several trophy amenities at once is where most property datasets fall apart.
• 15 named luxury brokerage networks — Sotheby's International Realty, Christie's International, Engel & Volkers, Savills, Douglas Elliman, Coldwell Banker Global Luxury, Corcoran, Barnes International Realty, John Taylor, Fine & Country, Luxury Portfolio International and more. Pick several and each network is collected separately, then merged and deduplicated.
• 17 property types including the ones nobody else indexes — Castle, Chateau, Finca, Private island, Farm / Ranch, Chalet, Estate, Penthouse, Country house and Land / Plot alongside the usual houses and apartments.
• Every price in EUR and USD, side by side — plus the seller's original listing currency and a dedicated "price on request" flag, so cross-border comparisons need no exchange-rate work on your side.
• Latitude and longitude on every property — drop the whole result set straight onto a heat map or into a GIS layer without a geocoding step.
• Up to 10 photographs per listing at 2,200px — full-resolution marketing imagery, plus the true gallery size so you know how many more exist.
• Nine sort orders including price per square metre — rank a market by price per m² lowest or highest first, by living area, by newest, or by JamesEdition's own Featured and Most popular ordering.
• Location matching that finds the real market — type "Miami" and you get Miami, Florida with its 3,600+ prime listings, not the same-named village with one. Works identically across the English, German, French, Spanish and Italian editions of the site.

Use Cases

Luxury Market Research

• Track asking prices and price per m² across Marbella, Saint-Tropez, Aspen and Dubai side by side
• Measure inventory depth by property type in any prime market
• Compare Alpine ski-in/ski-out supply against Mediterranean waterfront supply
• Benchmark new-build versus historic stock using the year-built filters

Brokerage & Competitive Intelligence

• Map how many properties each of the 15 major luxury networks lists in your territory
• Monitor a competitor brokerage's inventory, pricing, and photography quality
• Identify which offices dominate a niche such as vineyards, equestrian estates, or private islands
• Build agent and office directories with profile links for target regions

Investment & Portfolio Sourcing

• Screen for undervalued stock by sorting a market by price per m² lowest first
• Filter estates by minimum land area to find vineyard, ranch, and development opportunities
• Isolate properties tagged as investment property or new build
• Track how much high-end supply sits behind a "price on request" wall in each market

Relocation & Buyer Advisory

• Build client-ready shortlists filtered on exact bedroom, bathroom, and living-area requirements
• Surface only properties with a video tour or 3D walkthrough for remote buyers
• Assemble gated-community or private-beach options for privacy-sensitive clients
• Deliver localized shortlists using the German, French, Spanish, or Italian site edition

Data Products & Integration

• Feed a luxury property portal or comparison site with fresh, structured inventory
• Enrich an existing CRM with coordinates, imagery, and brokerage attribution
• Power map-based search products using the latitude/longitude on every row
• Run scheduled refreshes and diff the results to detect new listings and price changes

Getting Started

Simplest Possible Run

A location and a cap — nothing else:

{
    "location": "Marbella, Spain",
    "maxResults": 100
}

A Filtered Market Search

Waterfront villas and estates in Tuscany between EUR 2M and EUR 9M, largest homes first:

{
    "location": "Tuscany, Italy",
    "propertyTypes": ["villa", "estate"],
    "priceMin": 2000000,
    "priceMax": 9000000,
    "bedroomsMin": 4,
    "sortBy": "living_area_desc",
    "maxResults": 300
}

Trophy Amenities Across Named Brokerages

Pool and sea view and helipad, listed by three of the biggest luxury networks:

{
    "location": "French Riviera",
    "features": ["pool", "sea-view", "helipad"],
    "brands": ["68", "76", "87"],
    "priceOnRequest": "exclude",
    "sortBy": "price_desc",
    "maxResults": 500
}

Full Detail, Several Markets At Once

Paste ready-made JamesEdition links — search pages or single property pages — and enrich each one:

{
    "startUrls": [
        "https://www.jamesedition.com/real_estate/aspen-co-usa",
        "https://www.jamesedition.com/real_estate/lake-como-italy",
        "https://www.jamesedition.com/real_estate/limonta-italy/lakefront-elegance-on-lake-como-18025908"
    ],
    "includeDetails": true,
    "maxResultsPerUrl": 500,
    "maxResults": 0,
    "language": "en"
}

Input Reference

What to Scrape

Parameter	Type	Prefill	Description
location	string	Marbella, Spain	Country, region, or city — for example "Marbella, Spain", "French Riviera", "Dubai", or "Tuscany". Leave empty to search every country at once.
startUrls	string[]	[]	Paste JamesEdition links — search-result pages or single property pages, in any site language. When provided, these replace the search fields.

Property Type, Price & Size

Parameter	Type	Prefill	Description
propertyTypes	select[]	all types	House, Villa, Apartment, Penthouse, Condo, Co-op, Townhouse, Bungalow, Chalet, Country house, Finca, Estate, Farm / Ranch, Castle, Chateau, Private island, Land / Plot.
priceMin / priceMax	integer	none	Price range in euros. JamesEdition compares in euros no matter which currency a seller lists in.
bedroomsMin / bedroomsMax	integer	none	Bedroom count range, 0–20.
bathroomsMin / bathroomsMax	integer	none	Bathroom count range, 0–20.
livingAreaMin / livingAreaMax	integer	none	Indoor living space in square metres.
landAreaMin / landAreaMax	integer	none	Plot size in square metres — the filter to reach for on estates, vineyards, and ranches.
yearBuiltMin / yearBuiltMax	integer	none	Construction year range, e.g. 2020 for recent builds or 1900 and earlier for historic homes.

Features, Brands & Media

Parameter	Type	Prefill	Description
features	select[]	none	54 features and settings — Pool, Indoor pool, Wine cellar, Cinema, Helipad, Airstrip / Private airport, Equestrian, Vineyard / Winery, Private beach, Ski-in / Ski-out, Gated community, Sea view, Golf view and more. Properties must offer all the features you pick.
brands	select[]	all brokerages	15 luxury brokerage networks. Pick several and each is searched separately, then merged.
hasVideo	boolean	false	Only properties that come with a video tour.
hasVirtualTour	boolean	false	Only properties with a 3D or virtual walkthrough.
priceOnRequest	select	Include everything	Three-way control: include everything, only properties with a published price, or only "price on request" properties.

Sorting, Detail & Language

Parameter	Type	Prefill	Description
sortBy	select	Featured (site default)	Featured, Most popular, Newest first, Price low→high, Price high→low, Living area smallest/largest first, Price per m² lowest/highest first.
includeDetails	boolean	false	Open every property page to add the seller description, amenity list, year built, exact living and land area, and extra photography. Richer, but slower.
language	select	English	English, German, French, Spanish, or Italian edition of the site. Affects site-generated labels; seller descriptions stay in their original language.

Limits

Parameter	Type	Prefill	Description
maxResults	integer	100	Total properties to collect across every search and URL. Set to 0 to collect everything available.
maxResultsPerUrl	integer	0	Cap per individual search or URL. 0 means no per-search limit.

The Prefill column is what the run form starts with, so those are the values you get when you press Start without changing anything. They are not applied to a run started through the API or a schedule with an empty input — such a run searches every country and collects up to 1,000 properties. Send the fields you want whenever you start a run programmatically.

Output

Every property is one row. Here is a real result with full details enabled:

{
    "listingId": "18025908",
    "url": "https://www.jamesedition.com/real_estate/limonta-italy/lakefront-elegance-on-lake-como-18025908",
    "title": "Villa in Oliveto Lario, Lombardy, Italy",
    "propertyType": "Villa",
    "price": 7000000,
    "currency": "EUR",
    "priceEur": 7000000,
    "priceUsd": 7963549,
    "priceOnRequest": false,
    "bedrooms": 5,
    "bathrooms": 4,
    "livingAreaSqm": 500,
    "landAreaSqm": 1500,
    "yearBuilt": 1971,
    "address": "Oliveto Lario, Lombardy, Italy",
    "city": "Oliveto Lario",
    "region": "Lombardia",
    "country": "Italy",
    "countryCode": "IT",
    "latitude": 45.9569456,
    "longitude": 9.2688213,
    "description": "In Limonta, a hamlet of Oliveto Lario along the western shore of Lake Como, stands a property that embodies the area's most authentic and secluded character...",
    "amenities": ["Lakefront", "Waterfront", "Lake View", "Panoramic / Scenic View", "Pool", "Garden", "Terrace", "Fireplace", "Open Kitchen", "Modern"],
    "badges": ["Video"],
    "tags": ["5 Beds", "4 Baths", "500 sqm"],
    "primaryImageUrl": "https://img.jamesedition.com/listing_images/2026/05/28/15/54/05/a8a045bf-89be-46dc-825d-60a5156e2224/je/2200xxs.jpg",
    "imageUrls": ["https://img.jamesedition.com/listing_images/2026/05/28/15/54/05/a8a045bf-89be-46dc-825d-60a5156e2224/je/2200xxs.jpg", "https://img.jamesedition.com/listing_images/2026/05/29/13/25/38/434e7544-e2f0-4331-88bf-6db61799f3b7/je/2200xxs.jpg"],
    "imageCount": 43,
    "agentName": "Yana Kovalenko",
    "agentUrl": "https://www.jamesedition.com/agents/yana-kovalenko-1594798",
    "officeName": "JARVES",
    "officeId": "241596",
    "officeUrl": "https://www.jamesedition.com/offices/real_estate/jarves-241596",
    "isPromoted": false,
    "searchUrl": "https://www.jamesedition.com/real_estate/lake-como-italy?real_estate_type[]=villa&order=premium",
    "scrapedAt": "2026-07-25T10:28:04.882893+00:00"
}

Core Fields

Field	Type	Description
listingId	string	Unique JamesEdition listing identifier — stable across runs, ideal as a primary key
url	string	Direct link to the property page
title	string	Listing headline as published
propertyType	string	Villa, Estate, Penthouse, Chalet, Castle, Private island, etc.
badges	string[]	Marketplace badges such as Video, Virtual tour, New
tags	string[]	Short spec chips shown on the card, e.g. 5 Beds, 500 sqm
isPromoted	boolean	true if the property is a paid featured placement rather than an organic match
searchUrl	string	The search this row came from — useful when you run many searches in one job
scrapedAt	string	ISO timestamp of data extraction

Pricing

Field	Type	Description
price	number	Asking price in the seller's own listing currency
currency	string	Currency code of price, e.g. EUR, USD, GBP, AED
priceEur	number	Asking price converted to euros — the field to sort and compare on
priceUsd	number	Asking price converted to US dollars
priceOnRequest	boolean	true when the seller publishes no asking price

Size, Layout & Description

Field	Type	Description
bedrooms	number	Bedroom count
bathrooms	number	Bathroom count
livingAreaSqm	number	Indoor living space in square metres
landAreaSqm	number	Plot size in square metres
yearBuilt	number	Construction year
description	string	Full seller-written property description
amenities	string[]	Complete amenity and setting list, e.g. Lakefront, Wine Cellar, Helipad

landAreaSqm, yearBuilt, description and amenities come from the property page — switch on Include Full Property Details to populate them.

Location

Field	Type	Description
address	string	Full location line as published
city	string	City or locality
region	string	Region, province, or state
country	string	Country name
countryCode	string	Two-letter country code, e.g. IT, ES, AE
latitude	number	Map latitude
longitude	number	Map longitude

Photography

Field	Type	Description
primaryImageUrl	string	Lead marketing photograph at 2,200px
imageUrls	string[]	Up to 10 photographs, each at 2,200px
imageCount	number	Size of the listing's gallery when JamesEdition publishes a photo counter for it — otherwise the number of photographs returned in imageUrls

Brokerage & Agent

Field	Type	Description
agentName	string	Listing agent name
agentUrl	string	Link to the agent's JamesEdition profile
officeName	string	Brokerage or office name
officeId	string	Brokerage identifier
officeUrl	string	Link to the brokerage's JamesEdition profile

Agent name and profile link are published on most but not all properties — some brokerages list the office only. officeName is present on virtually every row, so use it as the reliable seller field.

Tips for Best Results

• Split large markets into several searches. JamesEdition serves at most 1,500 properties per individual search. To go beyond that, list several entries under Start URLs — one per city, per price band, or per property type — because each entry gets its own 1,500-property allowance. Four price bands across one country gets you four times the depth.
• Let sorting choose your slice. Because a single search tops out at 1,500 properties, sortBy decides which 1,500 you get. Price: high to low gives you the trophy end of a market; Price per m²: lowest first gives you the value end.
• Pick several brokerage brands for extra depth. Each brand is collected as its own search and merged, so selecting three networks in a busy market can return well over 1,500 properties in a single run.
• Turn on Include Full Property Details only when you need the narrative. Descriptions, the full amenity list, year built, and exact land area live on the property page. Everything else — prices in three currencies, bedrooms, bathrooms, living area, city, country, coordinates, 10 photographs, agent and brokerage — already arrives without it, so leave it off for fast bulk collection.
• Set Price Visibility to "Only properties with a published price" when the output feeds a valuation model or a price index. Roughly the top slice of any luxury market hides its asking price, and this guarantees every row carries a number.
• Enter prices in euros, always. JamesEdition normalizes to euros regardless of the seller's listing currency, so priceMin: 2000000 means EUR 2M whether the property is priced in dirhams, pounds, or dollars.
• Be specific with location text. "Marbella, Spain" or "Lake Como, Italy" beats a bare "Marbella" or "Como" — the actor ranks candidate markets by how well they match your words and then by market size, so a precise "City, Country" lands you on the real market every time.

Pricing

From $6.50 per 1,000 results — flat pay-per-result, so a run's cost is fully predictable before you start it. Bronze, Silver, and Gold subscribers pay progressively less; the table below shows the total cost at each discount tier.

Results	No discount	Bronze	Silver	Gold
100	$0.78	$0.74	$0.70	$0.65
1,000	$7.80	$7.35	$6.95	$6.50
10,000	$78.00	$73.50	$69.50	$65.00
100,000	$780.00	$735.00	$695.00	$650.00

A "result" is one property row in the output dataset. No compute or time-based charges — you pay per result, plus a small fixed per-run start fee.

Integrations

Export data in JSON, CSV, Excel, XML, or RSS. Connect to 1,500+ apps via:

• Zapier / Make / n8n — Workflow automation
• Google Sheets — Direct spreadsheet export
• Slack / Email — Notifications on new results
• Webhooks — Trigger custom APIs on run completion
• Apify API — Full programmatic access

Legal & Ethical Use

This actor is built for legitimate luxury real estate research, market analysis, and business intelligence. You are responsible for complying with applicable laws and JamesEdition's Terms of Service. Collect only what you need, do not use extracted agent or brokerage details for unsolicited outreach or harassment, and respect the copyright of listing photography and seller-written descriptions when you republish or redistribute anything.