Documentation Index
Fetch the complete documentation index at: https://doc.fluximmo.io/llms.txt
Use this file to discover all available pages before exploring further.
Cette page liste les filtres communs aux endpoints search Properties et alertes Properties / Adverts. Le payload de filtres d’une alerte ADVERT est très proche de celui d’un search property — la structure d’une zone est identique, mais la cardinalité diffère : côté Property, location est un tableau (multi-zones combinées en OR) ; côté Advert, location est un objet unique. D’autres clés racine peuvent également différer. Il n’existe pas d’endpoint search ADVERT public ; les annonces brutes passent toujours par une alerte webhook.
Chaque sous-objet est optionnel ; les filtres absents ne contraignent pas le résultat. Tous les filtres top-level sont combinés en AND logique. Quand un filtre prend une array d’objets (ex. côté Property : location[], offer[]), les éléments de l’array sont combinés en OR. Côté Advert, location est un objet unique → pas de OR possible sur les zones.
Complétude des annonces variable. Selon les annonceurs, certains champs sont fréquemment renseignés (prix, surface, ville, type), d’autres rarement (nombre de toilettes, étage, exposition, équipements rares). Plus vous filtrez sur des champs rares, plus vous risquez d’écarter des biens pertinents. Privilégiez d’abord les filtres essentiels et n’affinez qu’au besoin.
location[] — zones géographiques
location est un tableau : plusieurs zones sont combinées en OR (ex. Paris OU 92 OU 93). Chaque entrée accepte exactement un des modes ci-dessous.
| Mode | Type | Exemple |
|---|
postalCode | string | "75011" |
inseeCode | string | "75056" |
department | string (2 chars) | "75" |
city | string | ⚠️ ignoré par le moteur |
locationCoordinate.geoBoundingBox | objet | bbox carte |
locationCoordinate.geoDistance | objet | rayon autour d’un point |
{ "location": [{ "postalCode": "75011" }, { "department": "92" }] }
offer[].type — type d’offre
offer est un tableau. Le champ type est un enum :
| Valeur | Sens |
|---|
OFFER_BUY | Vente |
OFFER_RENT | Location |
OFFER_LIFE_ANNUITY_SALE | Viager |
OFFER_HOLIDAYS | Location vacances |
OFFER_AUCTION | Vente aux enchères |
OFFER_BUSINESS_TAKE_OVER | Reprise de fonds de commerce |
OFFER_LEASE_BACK | Lease-back |
OFFER_UNKNOWN | Inconnu (à éviter) |
{ "offer": [{ "type": "OFFER_BUY" }] }
price — prix
| Champ | Type | Sens |
|---|
price.initial.value.min / .max | int | Range du prix initial (à la première publication). |
price.latest.value.min / .max | int | Range du prix courant (le plus récent). |
price.initial.valuePerArea.min / .max | int | Prix au m² initial. |
price.latest.valuePerArea.min / .max | int | Prix au m² courant. |
{ "price": { "latest": { "value": { "min": 200000, "max": 450000 } } } }
habitation — caractéristiques du logement
| Champ | Type |
|---|
habitation.surface.total.min / .max | int (m²) |
habitation.bedroomCount.min / .max | int |
habitation.roomCount.min / .max | int |
habitation.bathroomCount.min / .max | int |
habitation.wcCount.min / .max | int |
habitation.propertyCondition[] | array |
habitation.floor n’est pas un champ direct du DTO — il fait partie de habitation.characteristics ou habitation.features selon le modèle. Utilisez surface, bedroomCount, roomCount pour les filtres usuels.
{
"habitation": {
"surface": { "total": { "min": 40, "max": 80 } },
"bedroomCount": { "min": 2 },
"roomCount": { "min": 3 }
}
}
type[] — classe de bien
Tableau d’enum EnumPropertyClassDto :
| Valeur | Sens |
|---|
CLASS_FLAT | Appartement |
CLASS_HOUSE | Maison |
CLASS_PROGRAM | Programme neuf |
CLASS_LAND | Terrain |
CLASS_PARKING | Parking / box |
CLASS_OFFICE | Bureau |
CLASS_SHOP | Local commercial |
CLASS_PREMISES | Local pro / professionnel |
CLASS_BUILDING | Immeuble |
CLASS_ROOM | Chambre |
CLASS_OTHER | Autre |
CLASS_UNKNOWN | Inconnu (à éviter) |
{ "type": ["CLASS_FLAT", "CLASS_HOUSE"] }
| Champ | Type | Sens |
|---|
meta.isTotallyOffline | boolean | false = exclure les biens dont toutes les adverts sont offline. Très utile pour ne voir que des biens encore actifs. |
meta.firstSeenAt | range date | Première fois que Fluximmo a vu le bien (min / max ISO 8601). |
meta.lastSeenAt | range date | Dernière fois que Fluximmo a vu le bien. |
{
"meta": {
"isTotallyOffline": false,
"firstSeenAt": { "min": "2025-01-01T00:00:00Z" }
}
}
Filtres spécifiques Adverts (alerte)
Au-delà des filtres communs ci-dessus, les alertes ADVERTS exposent : isOnline (équivalent advert de meta.isTotallyOffline côté property), isPro, isExclusive, source (portail d’origine), seller[], firstSeenAt. Voir Advert — modèle complet.
Pour aller plus loin
