Classified représente une annonce source ; une ressource Property regroupe les annonces qui se rapportent à un même bien immobilier. La référence API générée reste la source pour les paramètres et les schémas de réponse.
Sélectionnez un endpoint
Utilisez un endpoint de récupération directe lorsque vous connaissez déjà un identifiant. Un
Classified est une annonce source ; une Property regroupe les annonces qui décrivent le même bien immobilier. Si vous partez d’une URL d’annonce, appelez GET /classifieds/lookup avec le paramètre de requête url pour retrouver cette annonce, ou GET /properties/lookup avec ce même paramètre pour retrouver le bien immobilier regroupé.
Utilisez la recherche de biens immobiliers lorsque vous avez besoin d’un ensemble filtré et paginé.
Comprendre la classification des programmes et le périmètre d’un bien
UnpropertyId identifie le regroupement d’annonces qu’Immoteur associe à un bien immobilier. Lorsqu’une source publie une annonce pour l’opération entière, le regroupement peut légitimement réunir ce programme et des annonces de lots distincts. Des prix, surfaces ou nombres de pièces différents ne constituent alors pas l’historique d’un seul logement ; une annonce Classified peut elle-même décrire le programme.
Les champs optionnels property.isNew et property.isProgram sont indépendants. isNew indique qu’une source présente le bien comme neuf ou récent. isProgram indique qu’une source le classe comme un programme, une vente sur plan ou une offre en cours de construction ; l’annonce peut porter soit sur le programme entier, qui peut comprendre plusieurs lots, soit sur un lot identifié.
Pour isProgram, une location vaut toujours false, y compris si la source fournit une valeur explicite différente. Hors location, une valeur booléenne explicite de la source prévaut, y compris true pour un annonceur non professionnel. Sans valeur explicite, un annonceur connu comme non professionnel donne false avant l’analyse de l’URL et du texte ; si l’annonceur est professionnel ou inconnu et que ces éléments restent insuffisants, le champ demeure absent.
Les deux champs peuvent valoir true. Dans une ressource Classified, ils reflètent les éléments disponibles dans la source ; une valeur false connue est renvoyée et l’absence d’élément suffisant laisse le champ absent. Dans une ressource Property, les valeurs connues de toutes les annonces actuellement rattachées doivent être concordantes ; l’absence de valeur connue ou une contradiction entre true et false laisse le champ absent.
Le filtre existant propertyIsProgram de POST /properties/search ne sélectionne que les valeurs connues qui correspondent à la valeur demandée. Il ne transforme pas une valeur absente en false, et aucun filtre isNew supplémentaire n’est introduit.
Pour un historique de prix, ne rassemblez pas les prix de lots distincts d’un même programme comme s’ils appartenaient à un logement unique.
Signaler une anomalie
Dans l’API publique v1, envoyezPOST /issues pour signaler une anomalie liée à une annonce, à un bien immobilier, à leur regroupement ou sans cible précise. Immoteur enregistre le signalement ; il ne corrige ni les données, ni le statut, ni le regroupement.
Pour issueKind: other, envoyez obligatoirement propertyIds, classifiedIds et un comment non vide. Chaque liste contient de 0 à 100 UUID ou URN UUID uniques et peut être vide ; les anciennes formes avec uniquement propertyId ou classifiedId renvoient 422 sans créer de signalement.
Pour choisir l’exemple à copier, remplacer les ID et corriger une réponse 422, consultez Signaler une anomalie avec l’API. La référence de POST /issues contient les neuf exemples JSON, les champs exacts et les réponses d’erreur.
Recherchez une annonce ou un bien à partir de son URL
Choisissez le lookup en fonction de la ressource que votre intégration doit récupérer. Fournissez l’URL d’annonce dansurl.
Recherchez des biens immobiliers
Le corps de requête requiertpage, transactionType et propertyTypes. Ajoutez des filtres optionnels uniquement lorsqu’ils correspondent au résultat recherché.
Parcourez les résultats de recherche
Après chaque réponse àPOST /properties/search, lisez meta.nextPage. S’il contient un numéro, envoyez la même requête de recherche avec cette valeur dans page. Lorsqu’il vaut null, il n’y a pas de page suivante.