# JamesEdition Property ## Overview | Property | Value | |----------|-------| | **Status** | active | | **Method** | `GET` | | **Endpoint** | `/v2/jamesedition/property` | | **Base URL** | `https://api.piloterr.com` | | **Credit Cost** | 1 credit per call | | **Documentation** | https://www.piloterr.com/library/jamesedition-property | ## Description Read one JamesEdition listing from its URL. ## Authentication - **Key Name:** `x-api-key` - **Location:** HTTP Header - **Get an API key:** https://app.piloterr.com/register ## Example Request ```bash curl --location --request GET 'https://api.piloterr.com/v2/jamesedition/property' \ --header 'Content-Type: application/json' \ --header 'x-api-key: YOUR_API_KEY' ``` ## Example Response ### Lake Starnberg apartment ```json { "id": "17793477", "url": "https://www.jamesedition.com/real_estate/munich-germany/alpine-panorama-above-lake-starnberg-new-build-project-near-munich-17793477", "image": "https://img.jamesedition.com/listing_images/2026/05/07/09/16/45/419dac60-8b4b-4032-ac51-9765ab7d3418/je/1040x620xc.jpg", "price": 670000, "specs": [ "1 Beds", "1 Baths", "44 Sqm" ], "title": "Alpine Panorama Above Lake Starnberg – New Build Project Near Munich", "lot_sqm": null, "bedrooms": 1, "currency": "EUR", "location": "Munich, Bavaria, Germany", "bathrooms": 1, "description": "Munich, Bavaria, Germany | 1 Bed, 1 Bath Apartment For Sale | €670,000 - FELDAFINGER HÖHE – LIVING WHERE OTHERS GO ON VACATION

In Feldafing on the...", "lot_display": null, "interior_sqm": 44, "price_display": "€670,000", "interior_display": "44 Sqm" } ``` ## Documentation ## Overview 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. ## Quickstart ``` 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//-`). A keyword returns 400. ## Parameters | Parameter | Required | Example | |---|---|---| | `query` | yes | listing URL from search | ## Response fields | 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. ## Use cases - 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. ## Error codes | 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 | ## Related endpoints [JamesEdition Search](https://www.piloterr.com/library/jamesedition-search)