Read one JamesEdition listing. Send the URL from results[].url of search. The response is a flat object with the same id, the printed asking price, beds, baths, interior size, location, and description.
price matches the amount in price_display, for example 670000 and €670,000. A price-change note on the page stays out of price_display. When the page says Price on request, price is null and price_display is that label.
GET https://api.piloterr.com/v2/jamesedition/property?query=https://www.jamesedition.com/real_estate/munich-germany/alpine-panorama-above-lake-starnberg-new-build-project-near-munich-17793477
query is required. It must be a listing URL on jamesedition.com (/real_estate/<place>/<slug>-<id>). A keyword returns 400.
| Parameter |
Required |
Example |
query |
yes |
listing URL from search |
| Field |
Type |
Meaning |
id |
string |
Same id as the search card |
url |
string |
Listing URL |
title |
string |
Page title |
price |
number or null |
Printed asking price |
price_display |
string or null |
Price label, without the price-change sentence |
currency |
string or null |
Currency of that label |
bedrooms |
integer or null |
Beds |
bathrooms |
integer or null |
Baths |
interior_sqm |
number or null |
Interior square meters |
interior_display |
string or null |
Interior label, such as 44 Sqm |
lot_sqm |
number or null |
Lot size when the page prints one |
lot_display |
string or null |
Lot label |
specs |
array of strings or null |
Spec lines as printed |
location |
string or null |
Location line |
description |
string or null |
Meta description |
image |
string or null |
Open Graph image |
The interior size on the listing can differ by a square meter from area_sqm on the search card. Each page prints its own figure. There is no results wrapper.
- Confirm the printed asking price of a search card before sending the home to a client.
- Fill a CRM row with
bedrooms, bathrooms, interior_sqm, and location.
- Keep
description and image for a short listing brief.
| Code |
Meaning |
400 |
Missing URL, a host other than jamesedition.com, or a URL that is not a listing |
401 |
Missing API key |
404 |
The page had no listing block |
500 |
The fetch failed |
JamesEdition Search