Skip to main content

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.

L’offre BaaS Fluximmo se compose de plusieurs moteurs, chacun exposé via une famille d’endpoints REST. La même clé API y donne accès, l’authentification est unifiée (x-api-key), et les filtres de recherche sont alignés entre les moteurs lorsque c’est pertinent.

​
Échelle & couverture

Les moteurs Fluximmo s’appuient sur une infrastructure de collecte et de vérification opérée en continu depuis 2017. Les ordres de grandeur ci-dessous donnent le contexte avant de choisir un mode d’intégration (search ponctuel, alerte webhook, replay analytique).
  • 75 000+ nouvelles annonces ingérées par jour sur les principaux portails français.
  • ~1 million d’annonces vérifiées quotidiennement (présence en ligne et variation de prix).
  • Médiane de 5 minutes entre publication portail et mise à disposition via webhook / API.
  • 99 % du marché immobilier français couvert.
  • Plusieurs centaines de millions d’annonces historisées depuis 2017, requêtables.
  • Plusieurs dizaines de millions d’events (alertes, webhooks) traités chaque jour.
  • Service en production continue depuis 2017, sans interruption.

​
Moteur de recherche

Coeur de l’offre : interroger le catalogue Fluximmo dédupliqué multi-portails. Une requête, un résultat propre, sans doublons inter-portails. C’est le mode d’accès BAAS API par défaut pour toute intégration qui veut “rechercher des biens” sans gérer la déduplication elle-même.
  • Endpoint principal : POST /v2/protected/properties/search — payload riche, pagination cursor, tri canonique FIRST_SEEN_AT DESC.
  • Variante allégée : POST /v2/protected/properties/search/lite — schéma de réponse réduit pour UI temps réel, mobile, autocomplete.
  • Refetch : GET /v2/protected/properties/{flxId} (unitaire) ou POST /v2/protected/properties/_many (bulk) pour récupérer un payload complet à partir d’un ou plusieurs IDs.
Côté ADVERTS, l’endpoint POST /v2/protected/adverts/search existe mais n’est pas activé par défaut (capability sur demande — voir Capabilities sur demande). En usage standard, les annonces brutes (1 URL = 1 advert) sont consommées via une alerte webhook ADVERT, qui livre le payload complet de chaque advert et ses events de cycle de vie. Le schéma de filtres est identique au search property.

​
Moteur d’alertes (webhooks)

Les alertes transforment une requête search en flux push : à chaque nouveau bien (ou nouvel event sur un bien déjà matché), Fluximmo POSTe sur votre webhook.
  • Properties : PUT /v2/protected/properties/search/alerts — payload IDs only, refetch ensuite. Match types CREATED + MERGED (uniquement à la fusion d’une nouvelle advert).
  • Adverts : PUT /v2/protected/adverts/search/alerts — payload complet, pas de refetch. Match types CREATED + ADVERT_EVENT (events PRICE, REPUBLISHED, UNPUBLISHED).
Détails : Match types & cycle de vie d’une alerte, Webhooks — architecture, retry, sécurité.

​
Moteur analytique

Statistiques agrégées sur le marché et sur votre périmètre :
  • Properties analytics : comptage et analytics agrégées sur les filtres properties (sans paginer) — utile pour estimer la taille d’un marché avant de lancer un search ou une alerte.
  • Market analytics : prix par zone (médianes, distributions, prix au m²), indicateurs de tension par ville.
Endpoints sous la tab Analytics.

​
Moteur géographique

Géocodage adressé et inverse, basés sur la BAN/BANO du gouvernement français. Utiles pour transformer une adresse en coordonnées (puis injecter en geoDistance dans un search), ou inversement étiqueter un point en adresse lisible. Endpoints sous la tab Géo, détails dans le playbook Géocoder pour search.

​
Moteur AI / Estimation

AVM (Automated Valuation Model) Fluximmo : prix central + intervalle pour un bien français à partir de sa localisation et de ses caractéristiques. Modèle V2 production, sub-second.

​
Pour aller plus loin