# API de données immobilières - Fluximmo V2 (2.1.0)

## Docs

- [PLAN ACTION CONCRET REFACTOR DOC](https://doc.fluximmo.io/PLAN_ACTION_CONCRET_REFACTOR_DOC.md)
- [RECOMMENDATION IMPROVE DOC](https://doc.fluximmo.io/RECOMMENDATION_IMPROVE_DOC.md)
- [Estimation IA expérimentale (legacy ref)](https://doc.fluximmo.io/api-ai-reference/estimations/estimate-the-price-of-a-property.md): Référence legacy. Voir la page V2 BETA.
- [Estimation immobilière lite — prix d'un bien (API V2)](https://doc.fluximmo.io/api-ai-reference/estimations/lite-property-estimation.md): Estimation de prix d'un bien immobilier français à partir de sa localisation, ses caractéristiques et son type d'offre.
- [Statistiques prix par zone](https://doc.fluximmo.io/api-analytics-reference/market-analytics/prices-per-area-statistics.md): Statistiques prix moyens / au m² par zone géographique.
- [Tension immobilière par ville](https://doc.fluximmo.io/api-analytics-reference/market-analytics/tension-city-statistics.md): Indicateur de tension immobilière (offre vs demande) par ville.
- [Compter les properties par filtres](https://doc.fluximmo.io/api-analytics-reference/properties-analytics/count-properties-for-search-filters.md): Comptage de properties matchant des filtres donnés (analytics légères).
- [Analytics generales par filtres](https://doc.fluximmo.io/api-analytics-reference/properties-analytics/properties-general-analytics-for-search-filters.md): Statistiques agrégées (prix moyen, distribution surface) sur des filtres.
- [Annuler un géocodage en cours](https://doc.fluximmo.io/api-geocoding-reference/batch-async/annuler-un-géocodage-en-attente-ou-en-cours.md): Annuler un géocodage batch en attente ou en cours d'exécution.
- [Créer un projet de géocodage batch](https://doc.fluximmo.io/api-geocoding-reference/batch-async/créer-un-nouveau-projet.md): Créer un projet asynchrone pour géocoder un grand volume d'adresses.
- [Configurer les paramètres du batch](https://doc.fluximmo.io/api-geocoding-reference/batch-async/définir-les-paramètres-du-traitement.md): Définir les colonnes et options de géocodage pour le projet batch.
- [Démarrer le géocodage batch](https://doc.fluximmo.io/api-geocoding-reference/batch-async/démander-le-démarrage-du-géocodage.md): Lancer l'exécution du géocodage sur le projet batch configuré.
- [Réinitialiser un projet batch](https://doc.fluximmo.io/api-geocoding-reference/batch-async/ré-initialise-un-géocodage-terminé-ou-en-erreur.md): Réinitialiser un géocodage terminé ou en erreur pour le relancer.
- [Détails d'un projet batch](https://doc.fluximmo.io/api-geocoding-reference/batch-async/récupérer-les-informations.md): Récupérer le statut et les métadonnées d'un projet de géocodage batch.
- [Supprimer un projet batch](https://doc.fluximmo.io/api-geocoding-reference/batch-async/supprimer-un-projet.md): Supprimer un projet de géocodage batch et ses fichiers associés.
- [Télécharger le fichier résultat](https://doc.fluximmo.io/api-geocoding-reference/batch-async/télécharger-le-fichier-résultat-du-projet.md): Télécharger le CSV résultat d'un projet de géocodage batch terminé.
- [Télécharger le fichier source](https://doc.fluximmo.io/api-geocoding-reference/batch-async/télécharger-le-fichier-source-du-projet.md): Télécharger le fichier d'entrée d'un projet de géocodage batch.
- [Uploader le fichier source](https://doc.fluximmo.io/api-geocoding-reference/batch-async/uploader-un-fichier-dentrée-pour-un-projet.md): Uploader le CSV d'entrée pour un projet de géocodage batch.
- [Découvrir le service de géocodage](https://doc.fluximmo.io/api-geocoding-reference/getcapabilities/découvrir-le-service.md): Métadonnées et capacités du service public BAN/BANO opéré par Fluximmo.
- [Géocodage inverse en masse (CSV)](https://doc.fluximmo.io/api-geocoding-reference/reverse/géocodage-inversé-en-masse-d’un-fichier-csv.md): Géocodage inverse par fichier CSV (mode synchrone, service public BAN/BANO).
- [Géocodage inverse (coordonnées → adresse)](https://doc.fluximmo.io/api-geocoding-reference/reverse/recherche-par-géocodage-inverse.md): Service public BAN/BANO opéré par Fluximmo : coordonnées GPS → adresse.
- [Géocodage direct en masse (CSV)](https://doc.fluximmo.io/api-geocoding-reference/search/géocodage-direct-en-masse-d’un-fichier-csv.md): Géocodage direct par fichier CSV (mode synchrone, service public BAN/BANO).
- [Géocodage direct (adresse → coordonnées)](https://doc.fluximmo.io/api-geocoding-reference/search/recherche-par-géocodage-direct.md): Service public BAN/BANO opéré par Fluximmo : adresse → coordonnées GPS.
- [Capabilities sur demande](https://doc.fluximmo.io/api-reference/capabilities-sur-demande.md): Endpoints non exposés publiquement par défaut + sur-mesure. Activation par mail à contact@fluximmo.com.
- [Modèle Advert](https://doc.fluximmo.io/api-v2-reference/_api-models/advert.md): Schéma complet d'une advert — annonce individuelle sur un portail (1 URL = 1 advert).
- [Modèle Property](https://doc.fluximmo.io/api-v2-reference/_api-models/property.md): Schéma complet d'une property — bien physique unique avec déduplication multi-portails.
- [Réactiver une alerte advert](https://doc.fluximmo.io/api-v2-reference/adverts-alerts/activate-a-search-advert-alert.md): Réactiver une alerte advert précédemment désactivée.
- [Créer une alerte adverts](https://doc.fluximmo.io/api-v2-reference/adverts-alerts/create-a-new-advert-alert-for-this-search.md): Alerte temps réel sur les adverts. Webhook avec payload complet + events PRICE/REPUBLISHED/UNPUBLISHED.
- [Désactiver une alerte advert](https://doc.fluximmo.io/api-v2-reference/adverts-alerts/deactivate-a-search-advert-alert.md): Désactiver une alerte advert (historique consultable).
- [Lister mes alertes adverts](https://doc.fluximmo.io/api-v2-reference/adverts-alerts/get-all-your-advert-alerts.md): Liste de toutes les alertes adverts actives sur la clé.
- [Historique des matches d'une alerte](https://doc.fluximmo.io/api-v2-reference/adverts-alerts/get-history-of-match-adverts-by-its-saved-search-flxid.md): Historique des adverts matchées par une alerte donnée.
- [Voir les critères d'une alerte advert](https://doc.fluximmo.io/api-v2-reference/adverts-alerts/get-the-search-criteria-of-an-advert-alert.md): Récupère les filtres d'une alerte advert par flxId.
- [Modifier une alerte advert](https://doc.fluximmo.io/api-v2-reference/adverts-alerts/update-the-search-criteria-of-an-advert-alert.md): Modifier les filtres d'une alerte sans perdre l'historique.
- [Rechercher des annonces (search ADVERTS)](https://doc.fluximmo.io/api-v2-reference/adverts-search/search-adverts.md): Recherche brute d'annonces avec filtres source-spécifiques (isPro, source, seller).
- [Récupérer une advert par flxId](https://doc.fluximmo.io/api-v2-reference/adverts/get-adverts-byt-their-flx_id.md): Refetch unitaire d'une advert (annonce sur un portail).
- [Récupérer une advert par URL](https://doc.fluximmo.io/api-v2-reference/adverts/retrieve-advert-by-url.md): Recherche d'une advert à partir de l'URL d'une annonce portail.
- [Consommation crédits](https://doc.fluximmo.io/api-v2-reference/consumption/get-your-credit-consumption.md): Voir la consommation crédits de la clé courante.
- [Match DPE à une annonce (V2 stable)](https://doc.fluximmo.io/api-v2-reference/dpe-match/match-dpe-à-une-annonce-immobilière.md): Retourne les DPE ADEME les plus similaires à une annonce immobilière, classés par score de similarité avec un niveau de confiance.
- [Recherche DPE — diagnostics énergétiques ADEME (API V2)](https://doc.fluximmo.io/api-v2-reference/dpe-search/recherche-dpe.md): Recherche filtrée et paginée de Diagnostics de Performance Énergétique (DPE) issus de l'open-data ADEME, enrichis du géocodage BAN.
- [Match DVF à un bien (V2 stable)](https://doc.fluximmo.io/api-v2-reference/dvf-match/match-dvf-à-un-bien-immobilier.md): Retourne les transactions DVF les plus similaires à un bien immobilier connu, classées par score de similarité.
- [Recherche DVF — transactions immobilières notariales](https://doc.fluximmo.io/api-v2-reference/dvf-search/recherche-dvf.md): Recherche filtrée et paginée des transactions immobilières DVF (prix de vente notariaux) en France.
- [Estimation expérimentale](https://doc.fluximmo.io/api-v2-reference/estimations/estimate-the-price-of-a-property.md): Estimation avec modèle expérimental (comparaison de modèles externes).
- [Estimation lite (V2)](https://doc.fluximmo.io/api-v2-reference/estimations/lite-property-estimation.md): Estimation rapide du prix d'un bien (modèle V2 production).
- [Statistiques prix par zone](https://doc.fluximmo.io/api-v2-reference/market-analytics/prices-per-area-statistics.md): Statistiques prix moyens / au m² par zone géographique.
- [Tension immobilière par ville](https://doc.fluximmo.io/api-v2-reference/market-analytics/tension-city-statistics.md): Indicateur de tension immobilière (offre vs demande) par ville.
- [Réactiver une alerte properties](https://doc.fluximmo.io/api-v2-reference/properties-alerts/activate-a-property-search-alert.md): Réactiver une alerte properties précédemment désactivée.
- [Créer une alerte properties](https://doc.fluximmo.io/api-v2-reference/properties-alerts/create-a-new-alert-for-this-property-search.md): Alerte temps réel sur les properties matchant des filtres. Webhook IDs only.
- [Créer plusieurs alertes properties](https://doc.fluximmo.io/api-v2-reference/properties-alerts/create-many-new-alert-for-property-search.md): Création bulk d'alertes properties (multi-territoires).
- [Désactiver une alerte properties](https://doc.fluximmo.io/api-v2-reference/properties-alerts/deactivate-a-property-search-alert.md): Désactiver une alerte properties (l'historique reste consultable).
- [Lister mes alertes properties](https://doc.fluximmo.io/api-v2-reference/properties-alerts/get-all-your-property-alerts.md): Liste de toutes les alertes properties actives sur la clé.
- [Historique des matches d'une alerte](https://doc.fluximmo.io/api-v2-reference/properties-alerts/get-history-of-match-properties-by-its-saved-search-flxid.md): Historique des properties matchées par une alerte donnée.
- [Voir les critères d'une alerte](https://doc.fluximmo.io/api-v2-reference/properties-alerts/get-the-search-criteria-of-a-propertyalert.md): Récupère les filtres d'une alerte properties par flxId.
- [Modifier une alerte properties](https://doc.fluximmo.io/api-v2-reference/properties-alerts/update-the-search-criteria-of-a-property-alert.md): Modifier les filtres d'une alerte sans perdre l'historique des matches.
- [Compter les properties par filtres](https://doc.fluximmo.io/api-v2-reference/properties-analytics/count-properties-for-search-filters.md): Comptage de properties matchant des filtres donnés (analytics légères).
- [Analytics generales par filtres](https://doc.fluximmo.io/api-v2-reference/properties-analytics/properties-general-analytics-for-search-filters.md): Statistiques agrégées (prix moyen, distribution surface) sur des filtres.
- [Recherche allégée (lite)](https://doc.fluximmo.io/api-v2-reference/properties-search/lite-search-properties.md): Variante allégée pour UI temps réel, mobile, autocomplete. Schéma de réponse réduit.
- [Biens similaires (lite)](https://doc.fluximmo.io/api-v2-reference/properties-search/lite-similar-search-properties.md): Trouver des biens similaires à un flxId ou un payload de référence.
- [Rechercher des biens (search PROPERTIES)](https://doc.fluximmo.io/api-v2-reference/properties-search/search-properties.md): Recherche analytique avec déduplication multi-portails. Filtres riches, géo avancée, pagination cursor.
- [Récupérer une property par flxId](https://doc.fluximmo.io/api-v2-reference/properties/get-a-property-by-its-flx_id.md): Refetch unitaire d'une property après réception d'un webhook.
- [Voir les signalements d'une property](https://doc.fluximmo.io/api-v2-reference/properties/getissue--get-raised-issues-for-a-given-property.md): Lister les issues remontées sur une property donnée.
- [Time-series des signalements](https://doc.fluximmo.io/api-v2-reference/properties/issuetimeseries--obtain-time-series-analysis-over-issues-for-all-the-properties.md): Analyse temporelle des signalements sur les properties.
- [Récupérer plusieurs properties par flxIds](https://doc.fluximmo.io/api-v2-reference/properties/retreive-properties-by-their-flx_ids.md): Refetch en lot — recommandé après webhook properties (IDs only).
- [Récupérer une property par advert flxId](https://doc.fluximmo.io/api-v2-reference/properties/retrieve-a-property-by-advert-flxid.md): Récupérer la property parente d'une advert donnée.
- [Récupérer une property par URL](https://doc.fluximmo.io/api-v2-reference/properties/retrieve-a-property-by-url.md): Recherche d'une property à partir de l'URL d'une annonce portail.
- [Properties similaires](https://doc.fluximmo.io/api-v2-reference/properties/similar-properties.md): Trouver des properties similaires à une property donnée.
- [Détails d'une agence par identifiant officiel](https://doc.fluximmo.io/api-v2-reference/realestate-companies/retrieve-a-realestate-company-from-its-official-identifier.md): Informations d'une agence immobilière à partir de son SIREN/SIRET.
- [Échantillon d'adverts (no-auth)](https://doc.fluximmo.io/api-v2-reference/sample-adverts/get-a-sample-of-ads.md): 10 adverts d'exemple sans authentification, pour découvrir le format.
- [Exemple de webhook adverts](https://doc.fluximmo.io/api-v2-reference/sample-adverts/sample-advert-webhook-body.md): Payload de webhook adverts type, pour tester votre endpoint.
- [Échantillon de properties (no-auth)](https://doc.fluximmo.io/api-v2-reference/sample-properties/get-a-sample-of-properties.md): 10 properties d'exemple sans authentification, pour découvrir le format.
- [Exemple de webhook properties](https://doc.fluximmo.io/api-v2-reference/sample-properties/sample-properties-webhook-body.md): Payload de webhook properties type, pour tester votre endpoint.
- [Liste des portails immobiliers](https://doc.fluximmo.io/api-v2-reference/system/get-the-list-of-real-estate-platforms.md): Liste des portails immobiliers couverts par Fluximmo.
- [Version de l'API](https://doc.fluximmo.io/api-v2-reference/system/getversion.md): Version courante de l'API Fluximmo.
- [Healthcheck](https://doc.fluximmo.io/api-v2-reference/system/healthz.md): Endpoint de healthcheck.
- [Authentification API Fluximmo — clé x-api-key](https://doc.fluximmo.io/authentification.md): Authentification par header `x-api-key`. Activation et gestion des clés via my.fluximmo.io.
- [DVF vs Fluximmo — quand utiliser lequel](https://doc.fluximmo.io/concepts/dvf-vs-fluximmo.md): Comparatif honnête entre DVF (prix de vente notariaux gouvernementaux) et Fluximmo (annonces temps réel) — usage combiné gagnant.
- [Filtres communs de recherche immobilière API](https://doc.fluximmo.io/concepts/filtres-communs.md): Référence des filtres communs : search Properties + alertes Properties + alertes Adverts. Location, offer, price, habitation, meta, type.
- [Match types & cycle de vie d'une alerte](https://doc.fluximmo.io/concepts/match-types-cycle-alerte.md): Comprendre les types de matches (CREATED, MERGED, ADVERT_EVENT) et pourquoi recréer une alerte fait perdre l'historique.
- [Property vs Advert — bien dédupliqué ou annonce portail](https://doc.fluximmo.io/concepts/property-vs-advert.md): Comprendre la différence entre Property (bien physique dédupliqué) et Advert (annonce portail) — décision matrix, propertyFlxId pour reconstituer la dédup côté client, anti-patterns.
- [Recherche géographique immobilière : zones, bbox, distance](https://doc.fluximmo.io/concepts/recherche-geographique.md): Filtrer par zone : 4 modes administratifs + 2 modes géométriques (bbox, distance) + multi-zones OR.
- [Webhooks API immobilier — retry, signature, payload](https://doc.fluximmo.io/concepts/webhooks.md): Architecture webhooks Fluximmo : retry, signature, IDs vs payload complet, bonnes pratiques de réception.
- [Quickstart API Fluximmo — premier appel en 5 minutes](https://doc.fluximmo.io/demarrer/quickstart.md): 5 minutes en self-service : sample no-auth → clé test gratuite → premier search.
- [Données d'exemple API immobilier sans clé (no-auth)](https://doc.fluximmo.io/demarrer/sample-data.md): 4 endpoints sample no-auth pour découvrir les structures Property, Advert et webhooks avant inscription.
- [Moteurs BaaS](https://doc.fluximmo.io/doc/main-concepts/baas.md): Cinq moteurs Fluximmo : recherche multi-portail, alertes webhook, analytics, géo, AI/estimation. Comment ils s'articulent côté API.
- [Properties & Adverts](https://doc.fluximmo.io/doc/main-concepts/properties-adverts.md): Le marché immobilier peut être conceptualisé de différentes manières. Nous proposons deux conceptualisations distinctes selon vos besoins : Properties & Adverts.
- [API Fluximmo — données immobilières françaises temps réel](https://doc.fluximmo.io/introduction.md): Search, alertes webhook, estimation IA et géocodage BAN/BANO en une seule API. Depuis 2017.
- [Contexte LLM — copier dans votre prompt](https://doc.fluximmo.io/llms-context.md): Bloc de contexte synthétique à coller dans ChatGPT/Claude/Cursor avant de demander un payload Fluximmo.
- [Recevoir une alerte ADVERT par département](https://doc.fluximmo.io/playbooks/alerte-advert-departement.md): Webhook temps réel sur les nouvelles annonces d'achat appartement dans un département (chasseur immo).
- [Estimer un bien immobilier via l'API Fluximmo](https://doc.fluximmo.io/playbooks/estimer-un-bien.md): Estimez le prix d'un bien immobilier français via l'API : localisation et caractéristiques en entrée, prix et fourchette (priceRange) en sortie.
- [Géocoder une adresse pour filtrer une recherche](https://doc.fluximmo.io/playbooks/geocoder-pour-search.md): Pipeline BAN/BANO Gouv (search/reverse) → injecter (lat, lon) ou postalCode dans un filtre Fluximmo.
- [Recherche géographique avancée](https://doc.fluximmo.io/playbooks/recherche-geographique-avancee.md): geoBoundingBox pour cartes interactives, geoDistance pour rayons, multi-zones OR pour multi-territoires.
- [Répliquer la BDD adverts en sync continue](https://doc.fluximmo.io/playbooks/replicate-bdd-adverts.md): Backfill historique sur webhook (par mail) + alerte ADVERT continue → BDD locale en miroir avec events PRICE/REPUBLISHED/UNPUBLISHED.
- [Recherche analytique PROPERTIES (Paris achat appartement)](https://doc.fluximmo.io/playbooks/search-properties-analytique.md): Cartographier le marché Paris achat appartement avec déduplication multi-portails, pagination cursor, stats prix m².
- [Suivre les changements de prix en temps réel](https://doc.fluximmo.io/playbooks/track-price-changes.md): Alerte ADVERT avec events PRICE/REPUBLISHED/UNPUBLISHED, parser le payload, stocker l'historique des prix.
- [Chasseur immo Paris — alerte achat appartement T2-T3](https://doc.fluximmo.io/playbooks/veille-chasseur-properties.md): Persona chasseur immobilier basé à Paris : alertes properties pour mandats achat appartement T2-T3 (350-650k€) consommées dans une app interne — infra légère vs adverts.
- [Recevoir des webhooks à fort volume — bonnes pratiques](https://doc.fluximmo.io/playbooks/webhook-volume-architecture.md): Architecture queue + worker async, ack rapide, idempotence, retry/DLX, observability.
- [Bonnes pratiques](https://doc.fluximmo.io/ressources/bonnes-pratiques.md): Pagination, retry, idempotence, refetch, validation webhook x-webhook-key — checklist production-ready.
- [Codes d'erreur](https://doc.fluximmo.io/ressources/codes-erreur.md): Format de réponse erreur Fluximmo + tableau des codes principaux + comment les corriger.
- [Foire aux questions](https://doc.fluximmo.io/ressources/faq.md): Réponses aux 15 questions les plus fréquentes — onboarding, propriétés vs adverts, webhooks, rate limits, billing.
- [Limites & rate limits de l'API Fluximmo](https://doc.fluximmo.io/ressources/limites-rate-limits.md): Limites payload (size, keywords, geo), quotas (clé test vs prod), comportement en cas de dépassement.
- [Startups & sur-mesure](https://doc.fluximmo.io/ressources/startups-et-sur-mesure.md): Conditions adaptées pour les jeunes équipes, sur-mesure au cas par cas, études de cas anonymisées.
- [Livraison des webhooks](https://doc.fluximmo.io/ressources/webhooks-livraison.md): Politique de retry, codes acceptés, SLO, validation x-webhook-key, debug.

## OpenAPI Specs

- [swagger-api-v2](https://doc.fluximmo.io/swagger-api-v2.json)
- [swagger-api-geocoding](https://doc.fluximmo.io/swagger-api-geocoding.json)
- [swagger-city](https://doc.fluximmo.io/swagger-city.json)
- [swagger-dvf](https://doc.fluximmo.io/swagger-dvf.json)
- [swagger-geography](https://doc.fluximmo.io/swagger-geography.json)
- [swagger-elasticimmo](https://doc.fluximmo.io/swagger-elasticimmo.json)
- [swagger-analytics](https://doc.fluximmo.io/swagger-analytics.json)
- [swagger-maps](https://doc.fluximmo.io/swagger-maps.json)

## Optional

- [Nous contacter](mailto:contact@fluximmo.com)