Skip to main content
Lite Property Estimation
curl --request POST \
  --url https://api.fluximmo.io/v2/protected/estimate/property/lite \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "habitation": {
    "roomCount": 2,
    "bedroomCount": 1,
    "surface": {
      "total": 100
    },
    "propertyCondition": {
      "constructionYear": 123,
      "generalConditions": []
    },
    "characteristics": {
      "hasBalcony": true,
      "hasCellar": true,
      "hasGarage": true,
      "hasLift": true,
      "hasParking": true,
      "hasPool": true,
      "hasTerrace": true
    },
    "climate": {
      "epcClimate": "GREENHOUSE_CLASSIFICATION_C",
      "epcEnergy": "ENERGY_CLASSIFICATION_C"
    },
    "features": {
      "furniture": null,
      "propertyFloor": 1,
      "propertyTotalFloor": 1
    }
  },
  "location": {
    "locationCoordinate": {
      "location": [
        6.374338,
        43.474648
      ]
    }
  },
  "type": "CLASS_HOUSE",
  "offer": {
    "type": "OFFER_BUY"
  },
  "land": {
    "surface": 123
  }
}
'
{
  "error": {
    "message": "<string>",
    "code": 123
  }
}

​
À quoi ça sert

POST /v2/protected/estimate/property/lite retourne une estimation AVM (Automated Valuation Model) du prix d’un bien immobilier en France, en quelques centaines de millisecondes. C’est le modèle V2 de production de Fluximmo, entraîné sur l’historique d’annonces et de transactions agrégé par la plateforme. L’endpoint accepte un payload synthétique : localisation (location.locationCoordinate.location au format [lng, lat]), caractéristiques du bien (habitation.surface.total, habitation.roomCount, habitation.bedroomCount), type de bien (CLASS_FLAT ou CLASS_HOUSE) et type d’offre (OFFER_BUY). Il retourne un prix central (data.price), un intervalle (data.priceRange.lower / upper) et des métadonnées optionnelles indiquant la qualité de l’estimation pour la zone considérée. Cas d’usage typiques : pricing automatique côté agent, peer comparison (comparer un bien à son marché local), pré-qualification d’opportunité, alimentation d’une UI d’estimation grand public, scoring de portefeuille.

​
Exemples

​
E1 — Appartement Paris (75001)

curl -X POST https://api.fluximmo.io/v2/protected/estimate/property/lite \
  -H "x-api-key: $FLUXIMMO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "location": { "locationCoordinate": { "location": [2.3376, 48.8606] } },
    "habitation": { "surface": { "total": 60 }, "roomCount": 3, "bedroomCount": 2 },
    "type": "CLASS_FLAT",
    "offer": { "type": "OFFER_BUY" }
  }'

​
E2 — Maison Bretagne (110m², 4 pièces)

curl -X POST https://api.fluximmo.io/v2/protected/estimate/property/lite \
  -H "x-api-key: $FLUXIMMO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "location": { "locationCoordinate": { "location": [-4.4861, 48.3904] } },
    "habitation": { "surface": { "total": 110 }, "roomCount": 4, "bedroomCount": 3 },
    "land": { "surface": 350 },
    "type": "CLASS_HOUSE",
    "offer": { "type": "OFFER_BUY" }
  }'

​
Liens utiles

Clé test gratuite — 1 semaine

Créez un compte sur my.fluximmo.io pour récupérer une clé API test gratuite (1 semaine, accès limité). Aucun paiement requis.

Authorizations

​
x-api-key
string
header
required

Body

application/json
​
habitation
object
required

Habitation characteristics of the property

​
location
object
required

Location details of the property

​
type
enum<string>
required

Type of the property

Available options:
CLASS_HOUSE,
CLASS_FLAT
Example:

"CLASS_HOUSE"

​
offer
object
required

Offer information of the property

​
land
object

Land details of the property

Response

​
error
object
required

Error object