> ## 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.

# Moteurs BaaS

> Cinq moteurs Fluximmo : recherche multi-portail, alertes webhook, analytics, géo, AI/estimation. Comment ils s'articulent côté API.

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`](/api-v2-reference/properties-search/search-properties) — payload riche, pagination cursor, tri canonique `FIRST_SEEN_AT DESC`.
* **Variante allégée** : [`POST /v2/protected/properties/search/lite`](/api-v2-reference/properties-search/lite-search-properties) — 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](/api-reference/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](/concepts/match-types-cycle-alerte), [Webhooks — architecture, retry, sécurité](/concepts/webhooks).

## 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](/playbooks/geocoder-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.

* **Endpoint** : [`POST /v2/protected/estimate/property/lite`](/api-ai-reference/estimations/lite-property-estimation)
* **Playbook** : [Estimer un bien](/playbooks/estimer-un-bien)

## Pour aller plus loin

* [Property vs Advert](/concepts/property-vs-advert) — quelle entité choisir pour votre cas d'usage.
* [Filtres communs](/concepts/filtres-communs) — référence des filtres partagés search property + alertes.
* [Capabilities sur demande](/api-reference/capabilities-sur-demande) — endpoints non publics par défaut.