Match DPE à une annonce (V2 stable) - API de données immobilières

Match DPE à une annonce immobilière

curl --request POST \
  --url https://api.fluximmo.io/v2/protected/opendata/dpe/match \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "filters": {
    "code_departement_ban": "75",
    "code_insee_ban": "75113",
    "code_postal_ban": "75013",
    "numero_dpe": "2600E0590119C",
    "type_batiment": "appartement",
    "surface_habitable_logement": {
      "min": 57
    },
    "date_etablissement_dpe": {
      "from": "2023-06-15"
    },
    "location": {
      "lat": 48.8566,
      "lon": 2.3522,
      "distance": "10km"
    }
  },
  "size": 5,
  "scoring_targets": {
    "conso_5_usages_par_m2_ep": 210,
    "emission_ges_5_usages_par_m2": 18,
    "etiquette_dpe": "D",
    "etiquette_ges": "C",
    "nombre_niveau_immeuble": 6,
    "numero_etage_appartement": 3,
    "periode_construction": "1948-1974",
    "nombre_niveau_logement": 2
  }
}
'

import requests

url = "https://api.fluximmo.io/v2/protected/opendata/dpe/match"

payload = {
    "filters": {
        "code_departement_ban": "75",
        "code_insee_ban": "75113",
        "code_postal_ban": "75013",
        "numero_dpe": "2600E0590119C",
        "type_batiment": "appartement",
        "surface_habitable_logement": { "min": 57 },
        "date_etablissement_dpe": { "from": "2023-06-15" },
        "location": {
            "lat": 48.8566,
            "lon": 2.3522,
            "distance": "10km"
        }
    },
    "size": 5,
    "scoring_targets": {
        "conso_5_usages_par_m2_ep": 210,
        "emission_ges_5_usages_par_m2": 18,
        "etiquette_dpe": "D",
        "etiquette_ges": "C",
        "nombre_niveau_immeuble": 6,
        "numero_etage_appartement": 3,
        "periode_construction": "1948-1974",
        "nombre_niveau_logement": 2
    }
}
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({
    filters: {
      code_departement_ban: '75',
      code_insee_ban: '75113',
      code_postal_ban: '75013',
      numero_dpe: '2600E0590119C',
      type_batiment: 'appartement',
      surface_habitable_logement: {min: 57},
      date_etablissement_dpe: {from: '2023-06-15'},
      location: {lat: 48.8566, lon: 2.3522, distance: '10km'}
    },
    size: 5,
    scoring_targets: {
      conso_5_usages_par_m2_ep: 210,
      emission_ges_5_usages_par_m2: 18,
      etiquette_dpe: 'D',
      etiquette_ges: 'C',
      nombre_niveau_immeuble: 6,
      numero_etage_appartement: 3,
      periode_construction: '1948-1974',
      nombre_niveau_logement: 2
    }
  })
};

fetch('https://api.fluximmo.io/v2/protected/opendata/dpe/match', 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/opendata/dpe/match",
  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([
    'filters' => [
        'code_departement_ban' => '75',
        'code_insee_ban' => '75113',
        'code_postal_ban' => '75013',
        'numero_dpe' => '2600E0590119C',
        'type_batiment' => 'appartement',
        'surface_habitable_logement' => [
                'min' => 57
        ],
        'date_etablissement_dpe' => [
                'from' => '2023-06-15'
        ],
        'location' => [
                'lat' => 48.8566,
                'lon' => 2.3522,
                'distance' => '10km'
        ]
    ],
    'size' => 5,
    'scoring_targets' => [
        'conso_5_usages_par_m2_ep' => 210,
        'emission_ges_5_usages_par_m2' => 18,
        'etiquette_dpe' => 'D',
        'etiquette_ges' => 'C',
        'nombre_niveau_immeuble' => 6,
        'numero_etage_appartement' => 3,
        'periode_construction' => '1948-1974',
        'nombre_niveau_logement' => 2
    ]
  ]),
  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/opendata/dpe/match"

	payload := strings.NewReader("{\n  \"filters\": {\n    \"code_departement_ban\": \"75\",\n    \"code_insee_ban\": \"75113\",\n    \"code_postal_ban\": \"75013\",\n    \"numero_dpe\": \"2600E0590119C\",\n    \"type_batiment\": \"appartement\",\n    \"surface_habitable_logement\": {\n      \"min\": 57\n    },\n    \"date_etablissement_dpe\": {\n      \"from\": \"2023-06-15\"\n    },\n    \"location\": {\n      \"lat\": 48.8566,\n      \"lon\": 2.3522,\n      \"distance\": \"10km\"\n    }\n  },\n  \"size\": 5,\n  \"scoring_targets\": {\n    \"conso_5_usages_par_m2_ep\": 210,\n    \"emission_ges_5_usages_par_m2\": 18,\n    \"etiquette_dpe\": \"D\",\n    \"etiquette_ges\": \"C\",\n    \"nombre_niveau_immeuble\": 6,\n    \"numero_etage_appartement\": 3,\n    \"periode_construction\": \"1948-1974\",\n    \"nombre_niveau_logement\": 2\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/opendata/dpe/match")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"filters\": {\n    \"code_departement_ban\": \"75\",\n    \"code_insee_ban\": \"75113\",\n    \"code_postal_ban\": \"75013\",\n    \"numero_dpe\": \"2600E0590119C\",\n    \"type_batiment\": \"appartement\",\n    \"surface_habitable_logement\": {\n      \"min\": 57\n    },\n    \"date_etablissement_dpe\": {\n      \"from\": \"2023-06-15\"\n    },\n    \"location\": {\n      \"lat\": 48.8566,\n      \"lon\": 2.3522,\n      \"distance\": \"10km\"\n    }\n  },\n  \"size\": 5,\n  \"scoring_targets\": {\n    \"conso_5_usages_par_m2_ep\": 210,\n    \"emission_ges_5_usages_par_m2\": 18,\n    \"etiquette_dpe\": \"D\",\n    \"etiquette_ges\": \"C\",\n    \"nombre_niveau_immeuble\": 6,\n    \"numero_etage_appartement\": 3,\n    \"periode_construction\": \"1948-1974\",\n    \"nombre_niveau_logement\": 2\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.fluximmo.io/v2/protected/opendata/dpe/match")

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  \"filters\": {\n    \"code_departement_ban\": \"75\",\n    \"code_insee_ban\": \"75113\",\n    \"code_postal_ban\": \"75013\",\n    \"numero_dpe\": \"2600E0590119C\",\n    \"type_batiment\": \"appartement\",\n    \"surface_habitable_logement\": {\n      \"min\": 57\n    },\n    \"date_etablissement_dpe\": {\n      \"from\": \"2023-06-15\"\n    },\n    \"location\": {\n      \"lat\": 48.8566,\n      \"lon\": 2.3522,\n      \"distance\": \"10km\"\n    }\n  },\n  \"size\": 5,\n  \"scoring_targets\": {\n    \"conso_5_usages_par_m2_ep\": 210,\n    \"emission_ges_5_usages_par_m2\": 18,\n    \"etiquette_dpe\": \"D\",\n    \"etiquette_ges\": \"C\",\n    \"nombre_niveau_immeuble\": 6,\n    \"numero_etage_appartement\": 3,\n    \"periode_construction\": \"1948-1974\",\n    \"nombre_niveau_logement\": 2\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "data": [
    {
      "score": 85.3,
      "confidence": "HIGH",
      "dpe": {
        "numero_dpe": "<string>",
        "adresse_ban": "<string>",
        "location": {
          "lat": 48.8566,
          "lon": 2.3522
        },
        "etiquette_dpe": "<string>",
        "etiquette_ges": "<string>",
        "conso_5_usages_par_m2_ep": 123,
        "emission_ges_5_usages_par_m2": 123,
        "surface_habitable_logement": 123,
        "date_etablissement_dpe": "2023-06-15",
        "date_fin_validite_dpe": "2033-06-15"
      }
    }
  ],
  "meta": {
    "ambiguous": false,
    "total": 3
  }
}

{
  "error": {
    "message": "<string>",
    "code": 123
  }
}

{
  "error": {
    "message": "<string>",
    "code": 123
  }
}

Match DPE à une annonce immobilière

curl --request POST \
  --url https://api.fluximmo.io/v2/protected/opendata/dpe/match \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "filters": {
    "code_departement_ban": "75",
    "code_insee_ban": "75113",
    "code_postal_ban": "75013",
    "numero_dpe": "2600E0590119C",
    "type_batiment": "appartement",
    "surface_habitable_logement": {
      "min": 57
    },
    "date_etablissement_dpe": {
      "from": "2023-06-15"
    },
    "location": {
      "lat": 48.8566,
      "lon": 2.3522,
      "distance": "10km"
    }
  },
  "size": 5,
  "scoring_targets": {
    "conso_5_usages_par_m2_ep": 210,
    "emission_ges_5_usages_par_m2": 18,
    "etiquette_dpe": "D",
    "etiquette_ges": "C",
    "nombre_niveau_immeuble": 6,
    "numero_etage_appartement": 3,
    "periode_construction": "1948-1974",
    "nombre_niveau_logement": 2
  }
}
'

import requests

url = "https://api.fluximmo.io/v2/protected/opendata/dpe/match"

payload = {
    "filters": {
        "code_departement_ban": "75",
        "code_insee_ban": "75113",
        "code_postal_ban": "75013",
        "numero_dpe": "2600E0590119C",
        "type_batiment": "appartement",
        "surface_habitable_logement": { "min": 57 },
        "date_etablissement_dpe": { "from": "2023-06-15" },
        "location": {
            "lat": 48.8566,
            "lon": 2.3522,
            "distance": "10km"
        }
    },
    "size": 5,
    "scoring_targets": {
        "conso_5_usages_par_m2_ep": 210,
        "emission_ges_5_usages_par_m2": 18,
        "etiquette_dpe": "D",
        "etiquette_ges": "C",
        "nombre_niveau_immeuble": 6,
        "numero_etage_appartement": 3,
        "periode_construction": "1948-1974",
        "nombre_niveau_logement": 2
    }
}
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({
    filters: {
      code_departement_ban: '75',
      code_insee_ban: '75113',
      code_postal_ban: '75013',
      numero_dpe: '2600E0590119C',
      type_batiment: 'appartement',
      surface_habitable_logement: {min: 57},
      date_etablissement_dpe: {from: '2023-06-15'},
      location: {lat: 48.8566, lon: 2.3522, distance: '10km'}
    },
    size: 5,
    scoring_targets: {
      conso_5_usages_par_m2_ep: 210,
      emission_ges_5_usages_par_m2: 18,
      etiquette_dpe: 'D',
      etiquette_ges: 'C',
      nombre_niveau_immeuble: 6,
      numero_etage_appartement: 3,
      periode_construction: '1948-1974',
      nombre_niveau_logement: 2
    }
  })
};

fetch('https://api.fluximmo.io/v2/protected/opendata/dpe/match', 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/opendata/dpe/match",
  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([
    'filters' => [
        'code_departement_ban' => '75',
        'code_insee_ban' => '75113',
        'code_postal_ban' => '75013',
        'numero_dpe' => '2600E0590119C',
        'type_batiment' => 'appartement',
        'surface_habitable_logement' => [
                'min' => 57
        ],
        'date_etablissement_dpe' => [
                'from' => '2023-06-15'
        ],
        'location' => [
                'lat' => 48.8566,
                'lon' => 2.3522,
                'distance' => '10km'
        ]
    ],
    'size' => 5,
    'scoring_targets' => [
        'conso_5_usages_par_m2_ep' => 210,
        'emission_ges_5_usages_par_m2' => 18,
        'etiquette_dpe' => 'D',
        'etiquette_ges' => 'C',
        'nombre_niveau_immeuble' => 6,
        'numero_etage_appartement' => 3,
        'periode_construction' => '1948-1974',
        'nombre_niveau_logement' => 2
    ]
  ]),
  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/opendata/dpe/match"

	payload := strings.NewReader("{\n  \"filters\": {\n    \"code_departement_ban\": \"75\",\n    \"code_insee_ban\": \"75113\",\n    \"code_postal_ban\": \"75013\",\n    \"numero_dpe\": \"2600E0590119C\",\n    \"type_batiment\": \"appartement\",\n    \"surface_habitable_logement\": {\n      \"min\": 57\n    },\n    \"date_etablissement_dpe\": {\n      \"from\": \"2023-06-15\"\n    },\n    \"location\": {\n      \"lat\": 48.8566,\n      \"lon\": 2.3522,\n      \"distance\": \"10km\"\n    }\n  },\n  \"size\": 5,\n  \"scoring_targets\": {\n    \"conso_5_usages_par_m2_ep\": 210,\n    \"emission_ges_5_usages_par_m2\": 18,\n    \"etiquette_dpe\": \"D\",\n    \"etiquette_ges\": \"C\",\n    \"nombre_niveau_immeuble\": 6,\n    \"numero_etage_appartement\": 3,\n    \"periode_construction\": \"1948-1974\",\n    \"nombre_niveau_logement\": 2\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/opendata/dpe/match")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"filters\": {\n    \"code_departement_ban\": \"75\",\n    \"code_insee_ban\": \"75113\",\n    \"code_postal_ban\": \"75013\",\n    \"numero_dpe\": \"2600E0590119C\",\n    \"type_batiment\": \"appartement\",\n    \"surface_habitable_logement\": {\n      \"min\": 57\n    },\n    \"date_etablissement_dpe\": {\n      \"from\": \"2023-06-15\"\n    },\n    \"location\": {\n      \"lat\": 48.8566,\n      \"lon\": 2.3522,\n      \"distance\": \"10km\"\n    }\n  },\n  \"size\": 5,\n  \"scoring_targets\": {\n    \"conso_5_usages_par_m2_ep\": 210,\n    \"emission_ges_5_usages_par_m2\": 18,\n    \"etiquette_dpe\": \"D\",\n    \"etiquette_ges\": \"C\",\n    \"nombre_niveau_immeuble\": 6,\n    \"numero_etage_appartement\": 3,\n    \"periode_construction\": \"1948-1974\",\n    \"nombre_niveau_logement\": 2\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.fluximmo.io/v2/protected/opendata/dpe/match")

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  \"filters\": {\n    \"code_departement_ban\": \"75\",\n    \"code_insee_ban\": \"75113\",\n    \"code_postal_ban\": \"75013\",\n    \"numero_dpe\": \"2600E0590119C\",\n    \"type_batiment\": \"appartement\",\n    \"surface_habitable_logement\": {\n      \"min\": 57\n    },\n    \"date_etablissement_dpe\": {\n      \"from\": \"2023-06-15\"\n    },\n    \"location\": {\n      \"lat\": 48.8566,\n      \"lon\": 2.3522,\n      \"distance\": \"10km\"\n    }\n  },\n  \"size\": 5,\n  \"scoring_targets\": {\n    \"conso_5_usages_par_m2_ep\": 210,\n    \"emission_ges_5_usages_par_m2\": 18,\n    \"etiquette_dpe\": \"D\",\n    \"etiquette_ges\": \"C\",\n    \"nombre_niveau_immeuble\": 6,\n    \"numero_etage_appartement\": 3,\n    \"periode_construction\": \"1948-1974\",\n    \"nombre_niveau_logement\": 2\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "data": [
    {
      "score": 85.3,
      "confidence": "HIGH",
      "dpe": {
        "numero_dpe": "<string>",
        "adresse_ban": "<string>",
        "location": {
          "lat": 48.8566,
          "lon": 2.3522
        },
        "etiquette_dpe": "<string>",
        "etiquette_ges": "<string>",
        "conso_5_usages_par_m2_ep": 123,
        "emission_ges_5_usages_par_m2": 123,
        "surface_habitable_logement": 123,
        "date_etablissement_dpe": "2023-06-15",
        "date_fin_validite_dpe": "2033-06-15"
      }
    }
  ],
  "meta": {
    "ambiguous": false,
    "total": 3
  }
}

{
  "error": {
    "message": "<string>",
    "code": 123
  }
}

{
  "error": {
    "message": "<string>",
    "code": 123
  }
}

À quoi ça sert

POST /v2/protected/opendata/dpe/match recherche, parmi les DPE de la base ADEME, les candidats les plus proches d’une annonce immobilière donnée. Contrairement à DPE Search qui renvoie une liste paginée et filtrée, Match renvoie les meilleurs candidats classés par similarité et accompagnés d’un score. Le payload sépare deux notions à ne pas confondre :

filters (pré-filtre dur) — exclut les candidats qui ne correspondent pas (géographie, plage de surface, type de bâtiment, plage de dates, codes ADEME/BAN). Un candidat hors de ces bornes n’apparaît jamais dans la réponse.
scoring_targets (ancres douces) — n’excluent rien. Elles influencent uniquement le classement : un candidat proche d’une ancre remonte dans le ranking, un candidat éloigné reste présent mais plus bas.

Chaque résultat porte un score normalisé de 0 à 100 et un confidence (HIGH, MEDIUM, LOW, REJECT). L’objet meta indique le nombre total de candidats trouvés et un drapeau ambiguous, vrai lorsque les deux premiers scores diffèrent de 5 points ou moins — utile pour signaler un match incertain à arbitrer manuellement. Cas d’usage typiques : retrouver le DPE exact d’une annonce, rapprocher un lot d’annonces de leurs DPE pour enrichir un portefeuille, ou estimer l’étiquette énergétique probable d’un bien à partir de ses caractéristiques.

Payload

Le corps de requête est un objet JSON.

Champ	Type	Obligatoire	Sens
`filters`	object	Non	Pré-filtre dur. Voir le détail ci-dessous.
`size`	integer	Non	Nombre de candidats retournés (1–20, défaut `5`).
`scoring_targets`	object	Non	Ancres de scoring. Voir le détail ci-dessous.

`filters` (pré-filtre dur)

Champ	Type	Sens
`code_departement_ban`	string	Code département BAN (2–3 caractères, ex. `75`, `2A`, `974`).
`code_insee_ban`	string	Code INSEE de la commune (5 caractères).
`code_postal_ban`	string	Code postal (5 chiffres).
`numero_dpe`	string	Numéro unique du DPE attribué par l’ADEME. Recherche par identifiant.
`type_batiment`	string	`appartement`, `maison` ou `immeuble`.
`surface_habitable_logement`	object	Plage de surface habitable en m² : `{ "min": number, "max": number }`.
`date_etablissement_dpe`	object	Plage de dates d’établissement : `{ "from": "YYYY-MM-DD", "to": "YYYY-MM-DD" }`.
`location`	object	Filtre géographique : `{ "lat": number, "lon": number, "distance": "10km" }`. Unités acceptées : `m`, `km`, `mi`, `ft`, `yd`, `nmi`.

`scoring_targets` (ancres douces)

Champ	Type	Sens
`conso_5_usages_par_m2_ep`	number	Consommation cible en kWh/m²/an. Rapproche les candidats à conso proche.
`emission_ges_5_usages_par_m2`	number	Émissions GES cibles en kgCO₂/m²/an.
`etiquette_dpe`	string	Étiquette énergie cible (`A`–`G`). Bonus de score si correspondance.
`etiquette_ges`	string	Étiquette GES cible (`A`–`G`). Bonus de score si correspondance.
`nombre_niveau_immeuble`	number	Nombre de niveaux de l’immeuble (0–200).
`numero_etage_appartement`	number	Étage de l’appartement (−10 à 200 ; valeur négative = sous-sol).
`periode_construction`	string	Période de construction cible (ex. `avant 1948`, `1948-1974`, `après 2021`).
`nombre_niveau_logement`	number	Nombre de niveaux du logement (0–200).

Réponse

L’API retourne un objet { data, meta }. data est un tableau de candidats classés par score décroissant. Chaque entrée contient :

Champ	Type	Sens
`score`	number	Score de similarité normalisé (0–100).
`confidence`	string	Niveau de confiance : `HIGH`, `MEDIUM`, `LOW` ou `REJECT`.
`dpe`	object	Champs clés du DPE retenu (projection Match).

L’objet dpe expose notamment numero_dpe, adresse_ban, location ({ lat, lon }), etiquette_dpe, etiquette_ges, conso_5_usages_par_m2_ep, emission_ges_5_usages_par_m2, surface_habitable_logement, date_etablissement_dpe et date_fin_validite_dpe. meta contient :

Champ	Type	Sens
`total`	number	Nombre total de candidats trouvés (au-delà de `size`).
`ambiguous`	boolean	`true` si les deux premiers scores diffèrent de 5 points ou moins.

Le contrat exact est documenté plus bas par le bloc OpenAPI (POST /v2/protected/opendata/dpe/match).

Exemple

Recherche par numéro de DPE

Lookup direct par identifiant ADEME : la recherche court-circuite le scoring et retourne le DPE correspondant.

curl -X POST https://api.fluximmo.io/v2/protected/opendata/dpe/match \
  -H "x-api-key: $FLUXIMMO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "filters": {
      "code_departement_ban": "75",
      "code_postal_ban": "75009",
      "numero_dpe": "2675E0698907D"
    }
  }'

Match multi-critères avec ancres de scoring

Pré-filtre dur sur la zone, le type et la plage de surface, puis classement affiné par quatre ancres douces.

curl -X POST https://api.fluximmo.io/v2/protected/opendata/dpe/match \
  -H "x-api-key: $FLUXIMMO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "filters": {
      "code_departement_ban": "75",
      "code_postal_ban": "75011",
      "type_batiment": "appartement",
      "surface_habitable_logement": { "min": 45, "max": 60 },
      "location": { "lat": 48.8592, "lon": 2.3789, "distance": "2km" }
    },
    "scoring_targets": {
      "etiquette_dpe": "D",
      "etiquette_ges": "C",
      "conso_5_usages_par_m2_ep": 210,
      "nombre_niveau_immeuble": 6
    },
    "size": 5
  }'

Liens utiles

DPE Search — recherche paginée — liste filtrée de DPE, sans scoring.
DVF vs Fluximmo — comprendre les sources de données open data.

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

filters

object

Show child attributes

size

integer

default:5

Page size

Required range: 1 <= x <= 20

scoring_targets

object

Scoring anchors (conso_5_usages_par_m2_ep/emission_ges_5_usages_par_m2/etiquette_dpe/etiquette_ges/nombre_niveau_immeuble). Influence ranking only — do not exclude candidates.

Show child attributes

Response

Candidats DPE classés par score de similarité

data

object[]

required

Candidats DPE classés par score de similarité

Show child attributes

​À quoi ça sert

​Payload

​filters (pré-filtre dur)

​scoring_targets (ancres douces)

​Réponse

​Exemple

​Recherche par numéro de DPE

​Match multi-critères avec ancres de scoring

​Liens utiles

Clé test gratuite — 1 semaine

Authorizations

Body

Response

À quoi ça sert

Payload

`filters` (pré-filtre dur)

`scoring_targets` (ancres douces)

Réponse

Exemple

Recherche par numéro de DPE

Match multi-critères avec ancres de scoring

Liens utiles