# 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)