AnchorUn flux de données d’annonces immobilières pour alimenter votre propre base

Constituez une copie locale des annonces sélectionnées, puis faites-la évoluer dans votre propre architecture. Ce modèle convient lorsqu’un produit, un data warehouse ou un processus métier doit conserver dans le temps les données d’annonces reçues d’Immoteur.

Il ne s’agit pas d’une copie non filtrée de toutes les ressources Immoteur. Les annonces sélectionnées doivent être publiquement exportables : en France, avec les champs requis, un Property lié non supprimé, une devise en euros ou absente et un statut professionnel du diffuseur renseigné, y compris lorsqu’il vaut false. Ce périmètre n’est pas limité aux seules annonces actives.

Préparez votre endpoint de réception avant de demander un export complet au service classifieds. Enregistrez chaque contenu reçu ou placez-le dans une file de traitement, conservez l’identifiant d’export et son état final, puis mettez à jour dans votre stockage les données reçues pour chaque identifiant d’annonce.

Un export complet peut être livré en plusieurs lots. Son message final contient items: [] et isComplete: true ; ne supposez ni nombre, ni taille, ni ordre de livraison fixes.

Utilisez un service distinct, classified ou classified-notification-batch, avec onlyNew=false, pour recevoir les mises à jour éligibles. Le service classifieds reste celui des exports complets et delta ; les deux services peuvent viser le même endpoint de réception tout en restant distincts.

Une même livraison peut être reçue plusieurs fois et les livraisons n’arrivent pas nécessairement dans l’ordre. Avant de répondre 2xx, enregistrez le corps de requête complet avec la paire X-Immoteur-Service-Id / X-Immoteur-Event-Id ; pour ces notifications, X-Immoteur-Event-Id reste stable entre les réessais.

Votre application utilise cette paire pour reconnaître le réessai d’une notification déjà enregistrée et ne pas répéter un traitement déjà terminé. Elle conserve néanmoins le contenu reçu afin de le traiter lorsque ce travail n’est pas encore terminé. Une nouvelle observation qui ne modifie que meta.lastSeenAt ne produit pas de notification en direct.

Un export delta nécessite un export complet préalable, terminé avec succès et compatible avec les filtres en cours. Si aucun export complet compatible n’est disponible parce qu’il est absent, expiré ou que les filtres ont changé, Immoteur livre automatiquement un export complet. Traitez donc l’exportType reçu, plutôt que le mode demandé ; modifier seulement l’URL de destination ne rend pas l’export préalable incompatible.

Votre application choisit quand demander un export delta ; il complète les notifications, sans promettre une base sans écart entre deux exports.

Dans votre base, stockez d’un côté les données d’annonce reçues d’Immoteur et, de l’autre, vos enrichissements métier, scores et tables d’analyse. Lorsqu’une nouvelle version d’une annonce arrive, mettez à jour les données reçues sans les mélanger avec les calculs et les ajouts propres à votre application.

L’absence d’une annonce dans un export ultérieur n’est pas, à elle seule, une instruction de suppression dans votre base.

Suivez le guide Synchroniser les annonces immobilières↗ pour configurer l’export, les notifications et la réconciliation. Le guide de livraison des webhooks↗ explique comment traiter les livraisons de façon fiable.

Créer un compte Immoteur