AnchorUne API d’annonces immobilières pour explorer, filtrer et intégrer vos données

Utilisez l’API lorsque votre équipe doit rechercher un segment immobilier, retrouver une ressource connue ou partir de l’URL d’une annonce. Elle distingue les annonces source Classified des regroupements de biens Property et expose les limites d’accès appliquées à l’intégration qui effectue la requête.

AnchorChoisir entre recherche, identifiant et URL

Choisissez le point de départ de votre intégration selon le besoin : un segment de marché, un identifiant Immoteur déjà connu ou l’URL d’une annonce.

AnchorRechercher un segment ou consulter des regroupements d’annonces

Une requête POST /properties/search exige page, transactionType et propertyTypes. Ajoutez les filtres de localisation, de prix, de caractéristiques, de sources ou de texte qui correspondent à votre segment. Utilisez meta.nextPage pour parcourir la même recherche jusqu’à ce qu’il soit null.

Récupérez ensuite un regroupement connu avec GET /properties/{id} ou partez d’une URL d’annonce avec GET /properties/lookup. Un Property peut regrouper les annonces d’un bien, d’un programme entier ou de plusieurs logements.

Application de recherche de biens filtrant les appartements à vendre à Paris 75 sous 700 000 €, avec un bien de 52,5 m² à 650 000 € et trois annonces source, dont deux disponibles et une retirée.

Cette vue aide à comparer les annonces source associées au même regroupement.

Les indicateurs property.isNew et property.isProgram sont facultatifs et indépendants ; l’absence d’une valeur ne doit pas être lue comme false. Ni un identifiant Property ni un identifiant Classified ne garantit l’historique d’un logement unique.

AnchorExaminer une annonce source

Une ressource Classified correspond à une annonce source. Consultez-la avec GET /classifieds/{id} ou retrouvez-la avec GET /classifieds/lookup à partir de son URL. La réponse peut inclure son URL source, ainsi que les prix current et initial de la transaction.

Une annonce Classified peut elle aussi décrire un programme. Elle ne prouve donc pas, à elle seule, l’identité ni l’historique complet d’un logement unique.

Application de consultation d’une annonce source seloger.com disponible, avec un prix actuel de 650 000 €, un prix initial de 680 000 €, une surface de 52,5 m², trois pièces, une action pour consulter l’annonce source et une photo d’appartement.

Cette vue aide à consulter une annonce source indépendamment de son regroupement.

AnchorVérifier le périmètre d’accès

Appelez GET /auth pour vérifier l’identité du token et lire meta.dataAccessLimit. Les accès aux départements, SIREN et SIRET s’appliquent à l’intégration ; vos filtres peuvent réduire ce périmètre, pas l’étendre.

Intégrez cette limite dans votre interface, vos analyses et vos tests d’acceptation. Une requête valide ne garantit pas de données en dehors du périmètre d’accès configuré.

AnchorConsulter le contrat et démarrer

Consultez la référence Mintlify de POST /properties/search pour le contrat de requête et de réponse. La documentation des ressources API décrit les schémas, les relations et les filtres en vigueur.

Capture de la référence Mintlify pour POST /properties/search, avec ses exemples documentaires de requête et de réponse.

Le démarrage rapide montre comment créer un token et vérifier une première requête.

Créer un compte Immoteur