Skip to main content
Piloterr
Back to library

JamesEdition Search API

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

Active1 credit = 1 requestGET/v2/jamesedition/search

Endpoint Overview

Detailed documentation, pricing, and usage examples.

OverviewLink to Overview

Search luxury homes on JamesEdition. A keyword such as villa calls /real_estate?q=villa. You can also send a results URL under /real_estate, for example https://www.jamesedition.com/real_estate/france. The response is { results, pagination }.

price is the amount printed on the card, and price_display is that label, such as €670,000. When the card says Price on request, price is null. price_usd and price_eur are the card's alternate amounts and can differ from price.

QuickstartLink to Quickstart

GET https://api.piloterr.com/v2/jamesedition/search?query=villa
GET https://api.piloterr.com/v2/jamesedition/search?query=villa&page=2
GET https://api.piloterr.com/v2/jamesedition/search?query=https://www.jamesedition.com/real_estate/france

Pass results[].url to /v2/jamesedition/property. The listing id matches results[].id.

ParametersLink to Parameters

Parameter Required Example
query yes villa
page no 2

query is a keyword or a jamesedition.com URL whose path starts with /real_estate and is not a single listing. A listing URL is rejected here. page starts at 1. Omit it for the first page. A page already present in a results URL is kept when you omit page or pass 1. A value of 2 or higher overrides it.

Response fieldsLink to Response fields

Field Type Meaning
results[].id string Listing id
results[].url string Listing URL
results[].title string or null Card title
results[].price number or null Printed amount. Null for Price on request
results[].price_display string or null Printed label
results[].currency string or null Currency of the printed label, such as EUR
results[].price_usd number or null USD amount stored on the card
results[].price_eur number or null EUR amount stored on the card
results[].city string or null City
results[].region string or null Region
results[].country string or null Country
results[].country_code string or null Country code, such as DE
results[].address string or null Address from the card
results[].category string or null Type, such as Apartment
results[].bedrooms integer or null Beds printed on the card
results[].bathrooms integer or null Baths printed on the card
results[].area_sqm number or null Interior size in square meters
results[].area_display string or null Size label, such as 43 sqm
results[].latitude number or null Latitude
results[].longitude number or null Longitude
results[].image string or null Card image
results[].badges array of strings or null Badges such as Promoted
results[].promoted boolean True when the card is promoted
results[].office_url string or null Agency URL
pagination.page integer Page you asked for
pagination.per_page integer Number of cards on this page
pagination.total_results null JamesEdition does not print a total on this page
pagination.total_pages null Not printed
pagination.next string or null Next page URL, or null when no next link is present

PaginationLink to Pagination

page starts at 1. Ids are unique on a page. Page 2 of villa returns pagination.page 2 and a next URL for page 3. next is null only when the page has no following link. total_results and total_pages stay null. The listing page can print a size that differs slightly from the card, because each page shows its own figure.

Use casesLink to Use cases

  • A buying agent searches villa and drops cards whose price_display is Price on request.
  • A developer compares price_eur and price_usd on promoted listings near Munich.
  • A relocation desk opens https://www.jamesedition.com/real_estate/france and walks pagination.next.

Error codesLink to Error codes

Code Meaning
400 Empty query, a host other than jamesedition.com, or a listing URL sent to search
401 Missing API key
404 The page had no listing cards
500 The fetch failed

JamesEdition Property

Related APIs

Expand your data capabilities with these complementary tools.

Ready to get started?

Your web scraping API is one click away. Start with +500 credits, no infrastructure to set up, no proxies to manage, and no credit card required.

  • +500 credits
  • No credit card required
  • All endpoints included