Property
L'entité centrale de l'API Stream Estate
Une Property représente un bien immobilier unique, agrégé depuis une ou plusieurs sources. Elle regroupe l'ensemble des listings (annonces publiées) qui la référencent.
Agrégation et déduplication
Une property regroupe plusieurs listings (annonces) crawlés sur différentes sources. La réponse les agrège en une vue canonique property, dédoublonne les publishers dans publishers[] (groupés par id), et conserve les variantes par annonce dans listings[] — chacune portant sa source.
propertyvue canonique agrégéepublishers[]→ pub X, pub Y (2 distincts)dédoublonnélistings[]variantes par annonce — chacune porte sa sourceSchéma
PropertySearchResultDTO :
| Champ | Type | Description |
|---|---|---|
id | string (UUID) | Identifiant public stable de la property |
property | object | Vue canonique agrégée (PropertySectionDTO) — contient les timestamps, le propertyType, transaction, area, unit, building, etc. |
publishers | array | Publishers dédoublonnés sur l'ensemble des listings (PublisherSectionDTO[]) |
listings | array | Entrées par listing (ListingSectionDTO[]), avec uniquement les variantes qui diffèrent de la vue canonique |
Les détails canoniques (surface, rooms, type, transaction, etc.) se trouvent dans property. listings[] ne contient que les variantes spécifiques à chaque annonce (titre, URL, publisher, dates de publication et tout champ qui s'écarte du canonique).
Endpoints
POST /properties— recherche via un arbrecriteria(voir Filtrage)GET /properties/{uuid}— détail d'une property