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
}
}
'import requests
url = "https://api.fluximmo.io/v2/protected/estimate/property/lite"
payload = {
"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": None,
"propertyFloor": 1,
"propertyTotalFloor": 1
}
},
"location": { "locationCoordinate": { "location": [6.374338, 43.474648] } },
"type": "CLASS_HOUSE",
"offer": { "type": "OFFER_BUY" },
"land": { "surface": 123 }
}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
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}
})
};
fetch('https://api.fluximmo.io/v2/protected/estimate/property/lite', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.fluximmo.io/v2/protected/estimate/property/lite",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'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
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.fluximmo.io/v2/protected/estimate/property/lite"
payload := strings.NewReader("{\n \"habitation\": {\n \"roomCount\": 2,\n \"bedroomCount\": 1,\n \"surface\": {\n \"total\": 100\n },\n \"propertyCondition\": {\n \"constructionYear\": 123,\n \"generalConditions\": []\n },\n \"characteristics\": {\n \"hasBalcony\": true,\n \"hasCellar\": true,\n \"hasGarage\": true,\n \"hasLift\": true,\n \"hasParking\": true,\n \"hasPool\": true,\n \"hasTerrace\": true\n },\n \"climate\": {\n \"epcClimate\": \"GREENHOUSE_CLASSIFICATION_C\",\n \"epcEnergy\": \"ENERGY_CLASSIFICATION_C\"\n },\n \"features\": {\n \"furniture\": null,\n \"propertyFloor\": 1,\n \"propertyTotalFloor\": 1\n }\n },\n \"location\": {\n \"locationCoordinate\": {\n \"location\": [\n 6.374338,\n 43.474648\n ]\n }\n },\n \"type\": \"CLASS_HOUSE\",\n \"offer\": {\n \"type\": \"OFFER_BUY\"\n },\n \"land\": {\n \"surface\": 123\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-api-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.fluximmo.io/v2/protected/estimate/property/lite")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"habitation\": {\n \"roomCount\": 2,\n \"bedroomCount\": 1,\n \"surface\": {\n \"total\": 100\n },\n \"propertyCondition\": {\n \"constructionYear\": 123,\n \"generalConditions\": []\n },\n \"characteristics\": {\n \"hasBalcony\": true,\n \"hasCellar\": true,\n \"hasGarage\": true,\n \"hasLift\": true,\n \"hasParking\": true,\n \"hasPool\": true,\n \"hasTerrace\": true\n },\n \"climate\": {\n \"epcClimate\": \"GREENHOUSE_CLASSIFICATION_C\",\n \"epcEnergy\": \"ENERGY_CLASSIFICATION_C\"\n },\n \"features\": {\n \"furniture\": null,\n \"propertyFloor\": 1,\n \"propertyTotalFloor\": 1\n }\n },\n \"location\": {\n \"locationCoordinate\": {\n \"location\": [\n 6.374338,\n 43.474648\n ]\n }\n },\n \"type\": \"CLASS_HOUSE\",\n \"offer\": {\n \"type\": \"OFFER_BUY\"\n },\n \"land\": {\n \"surface\": 123\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fluximmo.io/v2/protected/estimate/property/lite")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"habitation\": {\n \"roomCount\": 2,\n \"bedroomCount\": 1,\n \"surface\": {\n \"total\": 100\n },\n \"propertyCondition\": {\n \"constructionYear\": 123,\n \"generalConditions\": []\n },\n \"characteristics\": {\n \"hasBalcony\": true,\n \"hasCellar\": true,\n \"hasGarage\": true,\n \"hasLift\": true,\n \"hasParking\": true,\n \"hasPool\": true,\n \"hasTerrace\": true\n },\n \"climate\": {\n \"epcClimate\": \"GREENHOUSE_CLASSIFICATION_C\",\n \"epcEnergy\": \"ENERGY_CLASSIFICATION_C\"\n },\n \"features\": {\n \"furniture\": null,\n \"propertyFloor\": 1,\n \"propertyTotalFloor\": 1\n }\n },\n \"location\": {\n \"locationCoordinate\": {\n \"location\": [\n 6.374338,\n 43.474648\n ]\n }\n },\n \"type\": \"CLASS_HOUSE\",\n \"offer\": {\n \"type\": \"OFFER_BUY\"\n },\n \"land\": {\n \"surface\": 123\n }\n}"
response = http.request(request)
puts response.read_body{
"error": {
"message": "<string>",
"code": 123
}
}{
"error": {
"message": "<string>",
"code": 123
}
}{
"data": {
"price": 123,
"priceRange": {
"lower": 123,
"upper": 123
},
"metadata": {}
}
}Estimation lite (V2)
Estimation rapide du prix d’un bien (modèle V2 production).
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
}
}
'import requests
url = "https://api.fluximmo.io/v2/protected/estimate/property/lite"
payload = {
"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": None,
"propertyFloor": 1,
"propertyTotalFloor": 1
}
},
"location": { "locationCoordinate": { "location": [6.374338, 43.474648] } },
"type": "CLASS_HOUSE",
"offer": { "type": "OFFER_BUY" },
"land": { "surface": 123 }
}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
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}
})
};
fetch('https://api.fluximmo.io/v2/protected/estimate/property/lite', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.fluximmo.io/v2/protected/estimate/property/lite",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'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
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.fluximmo.io/v2/protected/estimate/property/lite"
payload := strings.NewReader("{\n \"habitation\": {\n \"roomCount\": 2,\n \"bedroomCount\": 1,\n \"surface\": {\n \"total\": 100\n },\n \"propertyCondition\": {\n \"constructionYear\": 123,\n \"generalConditions\": []\n },\n \"characteristics\": {\n \"hasBalcony\": true,\n \"hasCellar\": true,\n \"hasGarage\": true,\n \"hasLift\": true,\n \"hasParking\": true,\n \"hasPool\": true,\n \"hasTerrace\": true\n },\n \"climate\": {\n \"epcClimate\": \"GREENHOUSE_CLASSIFICATION_C\",\n \"epcEnergy\": \"ENERGY_CLASSIFICATION_C\"\n },\n \"features\": {\n \"furniture\": null,\n \"propertyFloor\": 1,\n \"propertyTotalFloor\": 1\n }\n },\n \"location\": {\n \"locationCoordinate\": {\n \"location\": [\n 6.374338,\n 43.474648\n ]\n }\n },\n \"type\": \"CLASS_HOUSE\",\n \"offer\": {\n \"type\": \"OFFER_BUY\"\n },\n \"land\": {\n \"surface\": 123\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-api-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.fluximmo.io/v2/protected/estimate/property/lite")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"habitation\": {\n \"roomCount\": 2,\n \"bedroomCount\": 1,\n \"surface\": {\n \"total\": 100\n },\n \"propertyCondition\": {\n \"constructionYear\": 123,\n \"generalConditions\": []\n },\n \"characteristics\": {\n \"hasBalcony\": true,\n \"hasCellar\": true,\n \"hasGarage\": true,\n \"hasLift\": true,\n \"hasParking\": true,\n \"hasPool\": true,\n \"hasTerrace\": true\n },\n \"climate\": {\n \"epcClimate\": \"GREENHOUSE_CLASSIFICATION_C\",\n \"epcEnergy\": \"ENERGY_CLASSIFICATION_C\"\n },\n \"features\": {\n \"furniture\": null,\n \"propertyFloor\": 1,\n \"propertyTotalFloor\": 1\n }\n },\n \"location\": {\n \"locationCoordinate\": {\n \"location\": [\n 6.374338,\n 43.474648\n ]\n }\n },\n \"type\": \"CLASS_HOUSE\",\n \"offer\": {\n \"type\": \"OFFER_BUY\"\n },\n \"land\": {\n \"surface\": 123\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fluximmo.io/v2/protected/estimate/property/lite")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"habitation\": {\n \"roomCount\": 2,\n \"bedroomCount\": 1,\n \"surface\": {\n \"total\": 100\n },\n \"propertyCondition\": {\n \"constructionYear\": 123,\n \"generalConditions\": []\n },\n \"characteristics\": {\n \"hasBalcony\": true,\n \"hasCellar\": true,\n \"hasGarage\": true,\n \"hasLift\": true,\n \"hasParking\": true,\n \"hasPool\": true,\n \"hasTerrace\": true\n },\n \"climate\": {\n \"epcClimate\": \"GREENHOUSE_CLASSIFICATION_C\",\n \"epcEnergy\": \"ENERGY_CLASSIFICATION_C\"\n },\n \"features\": {\n \"furniture\": null,\n \"propertyFloor\": 1,\n \"propertyTotalFloor\": 1\n }\n },\n \"location\": {\n \"locationCoordinate\": {\n \"location\": [\n 6.374338,\n 43.474648\n ]\n }\n },\n \"type\": \"CLASS_HOUSE\",\n \"offer\": {\n \"type\": \"OFFER_BUY\"\n },\n \"land\": {\n \"surface\": 123\n }\n}"
response = http.request(request)
puts response.read_body{
"error": {
"message": "<string>",
"code": 123
}
}{
"error": {
"message": "<string>",
"code": 123
}
}{
"data": {
"price": 123,
"priceRange": {
"lower": 123,
"upper": 123
},
"metadata": {}
}
}À 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" }
}'
import os, requests
resp = requests.post(
"https://api.fluximmo.io/v2/protected/estimate/property/lite",
headers={"x-api-key": os.environ["FLUXIMMO_API_KEY"]},
json={
"location": {"locationCoordinate": {"location": [2.3376, 48.8606]}},
"habitation": {"surface": {"total": 60}, "roomCount": 3, "bedroomCount": 2},
"type": "CLASS_FLAT",
"offer": {"type": "OFFER_BUY"},
},
timeout=30,
)
print(resp.json())
const resp = await fetch("https://api.fluximmo.io/v2/protected/estimate/property/lite", {
method: "POST",
headers: {
"x-api-key": process.env.FLUXIMMO_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({
location: { locationCoordinate: { location: [2.3376, 48.8606] } },
habitation: { surface: { total: 60 }, roomCount: 3, bedroomCount: 2 },
type: "CLASS_FLAT",
offer: { type: "OFFER_BUY" },
}),
});
console.log(await resp.json());
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" }
}'
import os, requests
resp = requests.post(
"https://api.fluximmo.io/v2/protected/estimate/property/lite",
headers={"x-api-key": os.environ["FLUXIMMO_API_KEY"]},
json={
"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"},
},
timeout=30,
)
print(resp.json())
const resp = await fetch("https://api.fluximmo.io/v2/protected/estimate/property/lite", {
method: "POST",
headers: {
"x-api-key": process.env.FLUXIMMO_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({
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" },
}),
});
console.log(await resp.json());
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
Body
application/json
Habitation characteristics of the property
Show child attributes
Show child attributes
Location details of the property
Show child attributes
Show child attributes
Type of the property
Available options:
CLASS_HOUSE, CLASS_FLAT Example:
"CLASS_HOUSE"
Offer information of the property
Show child attributes
Show child attributes
Land details of the property
Show child attributes
Show child attributes
Response
Error object
Show child attributes
Show child attributes
Was this page helpful?
⌘I