Piloterr

JamesEdition Search

GET
/v2/jamesedition/search

Search JamesEdition luxury homes by keyword or by a results URL.

Credit cost: 1 credit per call

Authentification

ApiKeyAuth
headerx-api-key<token>

Your API key. Include it in the x-api-key header for every request.

Paramètres de requête

query*string

Required. Keyword, for example villa, or a JamesEdition results URL such as https://www.jamesedition.com/real_estate/france. A single listing URL is rejected.

Examples:

villa
page?number

Optional. Page number starting at 1. Example: 2. Omitted means page 1. A page already present in a results URL is kept when this is omitted or 1.

Default"1"

Corps de la réponse

Successful response

application/json
  1. response
results?array<>
pagination?
Example Request
curl -X GET 'https://api.piloterr.com/v2/jamesedition/search?query=string'
Example Response
{  "results": [    {      "id": "17793477",      "url": "https://www.jamesedition.com/real_estate/munich-germany/alpine-panorama-above-lake-starnberg-new-build-project-near-munich-17793477",      "city": "Munich",      "image": "https://img.jamesedition.com/listing_images/2026/05/07/09/16/45/419dac60-8b4b-4032-ac51-9765ab7d3418/je/507x312xc.jpg",      "price": 670000,      "title": "Alpine Panorama above Lake Starnberg – New-Build Project near Munich",      "badges": [        "Directly from developer",        "Video",        "Promoted"      ],      "region": "Bavaria",      "address": "Munich, Bavaria, Germany",      "country": "Germany",      "area_sqm": 43,      "bedrooms": 1,      "category": "Apartment",      "currency": "EUR",      "latitude": 48.1351253,      "promoted": true,      "bathrooms": 1,      "longitude": 11.5819806,      "price_eur": 670000,      "price_usd": 750540,      "office_url": "https://www.jamesedition.com/offices/real_estate/c7-gruppe-505101",      "area_display": "43 sqm",      "country_code": "DE",      "price_display": "€670,000"    }  ],  "pagination": {    "next": "https://www.jamesedition.com/real_estate?q=villa&page=2",    "page": 1,    "per_page": 31,    "total_pages": null,    "total_results": null  }}