Aller au contenu principal
Piloterr
Retour à la bibliothèque

API JamesEdition Search

Recherchez des biens de luxe JamesEdition par mot-clé ou par URL de résultats.

Actif1 crédit = 1 requêteGET/v2/jamesedition/search

Vue d'ensemble de l'endpoint

Documentation détaillée, tarifs et exemples d'utilisation.

AperçuLink to Aperçu

Recherche des biens de luxe sur JamesEdition. Un mot-clé comme villa appelle /real_estate?q=villa. Une URL de résultats sous /real_estate est acceptée, par exemple https://www.jamesedition.com/real_estate/france. La réponse est { results, pagination }.

price est le montant imprimé sur la carte et price_display son libellé, par exemple €670,000. Si la carte affiche Price on request, price est null. price_usd et price_eur sont les montants alternatifs de la carte.

DémarrageLink to Démarrage

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

Passez results[].url à /v2/jamesedition/property. L'id est le même.

ParamètresLink to Paramètres

query est obligatoire : mot-clé ou URL /real_estate qui n'est pas une fiche. page est facultatif, commence à 1, exemple 2.

Champs et paginationLink to Champs et pagination

Les ids sont uniques sur une page. pagination.page est la page demandée. per_page est le nombre de cartes de la page. total_results et total_pages sont null. next est une URL tant qu'un lien de page suivante existe, et null sinon. La page 2 de villa a page égal à 2 et un next vers la page 3.

price et price_display décrivent le prix imprimé. bedrooms, bathrooms, area_sqm, city, country, category, image, badges et promoted viennent de la carte.

Cas d'usageLink to Cas d'usage

  • Un chasseur immobilier écarte les cartes Price on request.
  • Un promoteur compare price_eur et price_usd sur des biens promus près de Munich.
  • Un service relocation ouvre /real_estate/france et suit next.

ErreursLink to Erreurs

400 requête vide, mauvais domaine, ou URL de fiche envoyée à la recherche. 401 clé absente. 404 aucune carte. 500 échec du fetch.

Endpoint liéLink to Endpoint lié

Fiche JamesEdition

API associées

Étendez vos capacités data avec ces outils complémentaires.

Prêt à commencer ?

Votre API de scraping web est à un clic. Commencez avec +500 crédits, sans infrastructure à gérer, sans proxies à configurer, et sans carte bancaire.

  • +500 crédits
  • Aucune carte bancaire requise
  • Tous les endpoints inclus