Recherche DVF
curl --request POST \
--url https://api.fluximmo.io/v2/protected/opendata/dvf/search \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"filters": {
"id": "2014-871319",
"transaction_date": {
"from": "2023-09-15"
},
"transaction_type": [
"Vente"
],
"price_eur": {
"min": 265788
},
"price_per_m2_living_eur": {
"min": 3819
},
"price_per_m2_land_eur": {
"min": 171
},
"location": {
"lat": 48.8566,
"lon": 2.3522,
"distance": "10km"
},
"departement_code": "83",
"insee_code": "83137",
"postal_code": "83000",
"iris_code": "830680000",
"iris_type": [
"H"
],
"property_type": [
"Appartement"
],
"surface_m2": {
"min": 476
},
"main_rooms": {
"min": 3
},
"land_surface_m2": {
"min": 1288
},
"is_new_build": false,
"is_open_market": true,
"carrez_surface_m2": {
"min": 57.8
},
"soil_surface_m2": {
"min": 185
},
"garden_surface_m2": {
"min": 164
}
},
"size": 20,
"cursor": "<string>"
}
'import requests
url = "https://api.fluximmo.io/v2/protected/opendata/dvf/search"
payload = {
"filters": {
"id": "2014-871319",
"transaction_date": { "from": "2023-09-15" },
"transaction_type": ["Vente"],
"price_eur": { "min": 265788 },
"price_per_m2_living_eur": { "min": 3819 },
"price_per_m2_land_eur": { "min": 171 },
"location": {
"lat": 48.8566,
"lon": 2.3522,
"distance": "10km"
},
"departement_code": "83",
"insee_code": "83137",
"postal_code": "83000",
"iris_code": "830680000",
"iris_type": ["H"],
"property_type": ["Appartement"],
"surface_m2": { "min": 476 },
"main_rooms": { "min": 3 },
"land_surface_m2": { "min": 1288 },
"is_new_build": False,
"is_open_market": True,
"carrez_surface_m2": { "min": 57.8 },
"soil_surface_m2": { "min": 185 },
"garden_surface_m2": { "min": 164 }
},
"size": 20,
"cursor": "<string>"
}
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: {
id: '2014-871319',
transaction_date: {from: '2023-09-15'},
transaction_type: ['Vente'],
price_eur: {min: 265788},
price_per_m2_living_eur: {min: 3819},
price_per_m2_land_eur: {min: 171},
location: {lat: 48.8566, lon: 2.3522, distance: '10km'},
departement_code: '83',
insee_code: '83137',
postal_code: '83000',
iris_code: '830680000',
iris_type: ['H'],
property_type: ['Appartement'],
surface_m2: {min: 476},
main_rooms: {min: 3},
land_surface_m2: {min: 1288},
is_new_build: false,
is_open_market: true,
carrez_surface_m2: {min: 57.8},
soil_surface_m2: {min: 185},
garden_surface_m2: {min: 164}
},
size: 20,
cursor: '<string>'
})
};
fetch('https://api.fluximmo.io/v2/protected/opendata/dvf/search', 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/dvf/search",
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' => [
'id' => '2014-871319',
'transaction_date' => [
'from' => '2023-09-15'
],
'transaction_type' => [
'Vente'
],
'price_eur' => [
'min' => 265788
],
'price_per_m2_living_eur' => [
'min' => 3819
],
'price_per_m2_land_eur' => [
'min' => 171
],
'location' => [
'lat' => 48.8566,
'lon' => 2.3522,
'distance' => '10km'
],
'departement_code' => '83',
'insee_code' => '83137',
'postal_code' => '83000',
'iris_code' => '830680000',
'iris_type' => [
'H'
],
'property_type' => [
'Appartement'
],
'surface_m2' => [
'min' => 476
],
'main_rooms' => [
'min' => 3
],
'land_surface_m2' => [
'min' => 1288
],
'is_new_build' => false,
'is_open_market' => true,
'carrez_surface_m2' => [
'min' => 57.8
],
'soil_surface_m2' => [
'min' => 185
],
'garden_surface_m2' => [
'min' => 164
]
],
'size' => 20,
'cursor' => '<string>'
]),
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/dvf/search"
payload := strings.NewReader("{\n \"filters\": {\n \"id\": \"2014-871319\",\n \"transaction_date\": {\n \"from\": \"2023-09-15\"\n },\n \"transaction_type\": [\n \"Vente\"\n ],\n \"price_eur\": {\n \"min\": 265788\n },\n \"price_per_m2_living_eur\": {\n \"min\": 3819\n },\n \"price_per_m2_land_eur\": {\n \"min\": 171\n },\n \"location\": {\n \"lat\": 48.8566,\n \"lon\": 2.3522,\n \"distance\": \"10km\"\n },\n \"departement_code\": \"83\",\n \"insee_code\": \"83137\",\n \"postal_code\": \"83000\",\n \"iris_code\": \"830680000\",\n \"iris_type\": [\n \"H\"\n ],\n \"property_type\": [\n \"Appartement\"\n ],\n \"surface_m2\": {\n \"min\": 476\n },\n \"main_rooms\": {\n \"min\": 3\n },\n \"land_surface_m2\": {\n \"min\": 1288\n },\n \"is_new_build\": false,\n \"is_open_market\": true,\n \"carrez_surface_m2\": {\n \"min\": 57.8\n },\n \"soil_surface_m2\": {\n \"min\": 185\n },\n \"garden_surface_m2\": {\n \"min\": 164\n }\n },\n \"size\": 20,\n \"cursor\": \"<string>\"\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/dvf/search")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"filters\": {\n \"id\": \"2014-871319\",\n \"transaction_date\": {\n \"from\": \"2023-09-15\"\n },\n \"transaction_type\": [\n \"Vente\"\n ],\n \"price_eur\": {\n \"min\": 265788\n },\n \"price_per_m2_living_eur\": {\n \"min\": 3819\n },\n \"price_per_m2_land_eur\": {\n \"min\": 171\n },\n \"location\": {\n \"lat\": 48.8566,\n \"lon\": 2.3522,\n \"distance\": \"10km\"\n },\n \"departement_code\": \"83\",\n \"insee_code\": \"83137\",\n \"postal_code\": \"83000\",\n \"iris_code\": \"830680000\",\n \"iris_type\": [\n \"H\"\n ],\n \"property_type\": [\n \"Appartement\"\n ],\n \"surface_m2\": {\n \"min\": 476\n },\n \"main_rooms\": {\n \"min\": 3\n },\n \"land_surface_m2\": {\n \"min\": 1288\n },\n \"is_new_build\": false,\n \"is_open_market\": true,\n \"carrez_surface_m2\": {\n \"min\": 57.8\n },\n \"soil_surface_m2\": {\n \"min\": 185\n },\n \"garden_surface_m2\": {\n \"min\": 164\n }\n },\n \"size\": 20,\n \"cursor\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fluximmo.io/v2/protected/opendata/dvf/search")
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 \"id\": \"2014-871319\",\n \"transaction_date\": {\n \"from\": \"2023-09-15\"\n },\n \"transaction_type\": [\n \"Vente\"\n ],\n \"price_eur\": {\n \"min\": 265788\n },\n \"price_per_m2_living_eur\": {\n \"min\": 3819\n },\n \"price_per_m2_land_eur\": {\n \"min\": 171\n },\n \"location\": {\n \"lat\": 48.8566,\n \"lon\": 2.3522,\n \"distance\": \"10km\"\n },\n \"departement_code\": \"83\",\n \"insee_code\": \"83137\",\n \"postal_code\": \"83000\",\n \"iris_code\": \"830680000\",\n \"iris_type\": [\n \"H\"\n ],\n \"property_type\": [\n \"Appartement\"\n ],\n \"surface_m2\": {\n \"min\": 476\n },\n \"main_rooms\": {\n \"min\": 3\n },\n \"land_surface_m2\": {\n \"min\": 1288\n },\n \"is_new_build\": false,\n \"is_open_market\": true,\n \"carrez_surface_m2\": {\n \"min\": 57.8\n },\n \"soil_surface_m2\": {\n \"min\": 185\n },\n \"garden_surface_m2\": {\n \"min\": 164\n }\n },\n \"size\": 20,\n \"cursor\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"data": [
{
"id": "2014-871319",
"transaction_date": "2023-09-15",
"transaction_type": "Vente",
"price_eur": 265788,
"price_per_m2_living_eur": 3819,
"price_per_m2_land_eur": 171,
"location": {
"lat": 48.8566,
"lon": 2.3522
},
"departement_code": "83",
"insee_code": "83137",
"postal_code": "83000",
"city_name": "<string>",
"street_number": "9001",
"street_name": "<string>",
"address": "<string>",
"iris_code": "830680000",
"iris_name": "<string>",
"iris_type": "H",
"property_type": "Appartement",
"surface_m2": 476,
"main_rooms": 3,
"transaction_class": "logement_sans_terrain",
"land_surface_m2": 1288,
"parcel_count": 1,
"housing_count": 1,
"house_count": 0,
"apartment_count": 0,
"outbuilding_count": 1,
"commercial_count": 0,
"is_new_build": false,
"is_open_market": true,
"carrez_surface_m2": 57.8,
"soil_surface_m2": 185,
"garden_surface_m2": 164
}
],
"total": 123,
"size": 123,
"hasMore": true,
"cursor": "<string>",
"from": 123
}{
"error": {
"message": "<string>",
"code": 123
}
}{
"error": {
"message": "<string>",
"code": 123
}
}DVF
Recherche DVF — transactions immobilières notariales
Recherche filtrée et paginée des transactions immobilières DVF (prix de vente notariaux) en France.
Recherche DVF
curl --request POST \
--url https://api.fluximmo.io/v2/protected/opendata/dvf/search \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"filters": {
"id": "2014-871319",
"transaction_date": {
"from": "2023-09-15"
},
"transaction_type": [
"Vente"
],
"price_eur": {
"min": 265788
},
"price_per_m2_living_eur": {
"min": 3819
},
"price_per_m2_land_eur": {
"min": 171
},
"location": {
"lat": 48.8566,
"lon": 2.3522,
"distance": "10km"
},
"departement_code": "83",
"insee_code": "83137",
"postal_code": "83000",
"iris_code": "830680000",
"iris_type": [
"H"
],
"property_type": [
"Appartement"
],
"surface_m2": {
"min": 476
},
"main_rooms": {
"min": 3
},
"land_surface_m2": {
"min": 1288
},
"is_new_build": false,
"is_open_market": true,
"carrez_surface_m2": {
"min": 57.8
},
"soil_surface_m2": {
"min": 185
},
"garden_surface_m2": {
"min": 164
}
},
"size": 20,
"cursor": "<string>"
}
'import requests
url = "https://api.fluximmo.io/v2/protected/opendata/dvf/search"
payload = {
"filters": {
"id": "2014-871319",
"transaction_date": { "from": "2023-09-15" },
"transaction_type": ["Vente"],
"price_eur": { "min": 265788 },
"price_per_m2_living_eur": { "min": 3819 },
"price_per_m2_land_eur": { "min": 171 },
"location": {
"lat": 48.8566,
"lon": 2.3522,
"distance": "10km"
},
"departement_code": "83",
"insee_code": "83137",
"postal_code": "83000",
"iris_code": "830680000",
"iris_type": ["H"],
"property_type": ["Appartement"],
"surface_m2": { "min": 476 },
"main_rooms": { "min": 3 },
"land_surface_m2": { "min": 1288 },
"is_new_build": False,
"is_open_market": True,
"carrez_surface_m2": { "min": 57.8 },
"soil_surface_m2": { "min": 185 },
"garden_surface_m2": { "min": 164 }
},
"size": 20,
"cursor": "<string>"
}
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: {
id: '2014-871319',
transaction_date: {from: '2023-09-15'},
transaction_type: ['Vente'],
price_eur: {min: 265788},
price_per_m2_living_eur: {min: 3819},
price_per_m2_land_eur: {min: 171},
location: {lat: 48.8566, lon: 2.3522, distance: '10km'},
departement_code: '83',
insee_code: '83137',
postal_code: '83000',
iris_code: '830680000',
iris_type: ['H'],
property_type: ['Appartement'],
surface_m2: {min: 476},
main_rooms: {min: 3},
land_surface_m2: {min: 1288},
is_new_build: false,
is_open_market: true,
carrez_surface_m2: {min: 57.8},
soil_surface_m2: {min: 185},
garden_surface_m2: {min: 164}
},
size: 20,
cursor: '<string>'
})
};
fetch('https://api.fluximmo.io/v2/protected/opendata/dvf/search', 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/dvf/search",
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' => [
'id' => '2014-871319',
'transaction_date' => [
'from' => '2023-09-15'
],
'transaction_type' => [
'Vente'
],
'price_eur' => [
'min' => 265788
],
'price_per_m2_living_eur' => [
'min' => 3819
],
'price_per_m2_land_eur' => [
'min' => 171
],
'location' => [
'lat' => 48.8566,
'lon' => 2.3522,
'distance' => '10km'
],
'departement_code' => '83',
'insee_code' => '83137',
'postal_code' => '83000',
'iris_code' => '830680000',
'iris_type' => [
'H'
],
'property_type' => [
'Appartement'
],
'surface_m2' => [
'min' => 476
],
'main_rooms' => [
'min' => 3
],
'land_surface_m2' => [
'min' => 1288
],
'is_new_build' => false,
'is_open_market' => true,
'carrez_surface_m2' => [
'min' => 57.8
],
'soil_surface_m2' => [
'min' => 185
],
'garden_surface_m2' => [
'min' => 164
]
],
'size' => 20,
'cursor' => '<string>'
]),
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/dvf/search"
payload := strings.NewReader("{\n \"filters\": {\n \"id\": \"2014-871319\",\n \"transaction_date\": {\n \"from\": \"2023-09-15\"\n },\n \"transaction_type\": [\n \"Vente\"\n ],\n \"price_eur\": {\n \"min\": 265788\n },\n \"price_per_m2_living_eur\": {\n \"min\": 3819\n },\n \"price_per_m2_land_eur\": {\n \"min\": 171\n },\n \"location\": {\n \"lat\": 48.8566,\n \"lon\": 2.3522,\n \"distance\": \"10km\"\n },\n \"departement_code\": \"83\",\n \"insee_code\": \"83137\",\n \"postal_code\": \"83000\",\n \"iris_code\": \"830680000\",\n \"iris_type\": [\n \"H\"\n ],\n \"property_type\": [\n \"Appartement\"\n ],\n \"surface_m2\": {\n \"min\": 476\n },\n \"main_rooms\": {\n \"min\": 3\n },\n \"land_surface_m2\": {\n \"min\": 1288\n },\n \"is_new_build\": false,\n \"is_open_market\": true,\n \"carrez_surface_m2\": {\n \"min\": 57.8\n },\n \"soil_surface_m2\": {\n \"min\": 185\n },\n \"garden_surface_m2\": {\n \"min\": 164\n }\n },\n \"size\": 20,\n \"cursor\": \"<string>\"\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/dvf/search")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"filters\": {\n \"id\": \"2014-871319\",\n \"transaction_date\": {\n \"from\": \"2023-09-15\"\n },\n \"transaction_type\": [\n \"Vente\"\n ],\n \"price_eur\": {\n \"min\": 265788\n },\n \"price_per_m2_living_eur\": {\n \"min\": 3819\n },\n \"price_per_m2_land_eur\": {\n \"min\": 171\n },\n \"location\": {\n \"lat\": 48.8566,\n \"lon\": 2.3522,\n \"distance\": \"10km\"\n },\n \"departement_code\": \"83\",\n \"insee_code\": \"83137\",\n \"postal_code\": \"83000\",\n \"iris_code\": \"830680000\",\n \"iris_type\": [\n \"H\"\n ],\n \"property_type\": [\n \"Appartement\"\n ],\n \"surface_m2\": {\n \"min\": 476\n },\n \"main_rooms\": {\n \"min\": 3\n },\n \"land_surface_m2\": {\n \"min\": 1288\n },\n \"is_new_build\": false,\n \"is_open_market\": true,\n \"carrez_surface_m2\": {\n \"min\": 57.8\n },\n \"soil_surface_m2\": {\n \"min\": 185\n },\n \"garden_surface_m2\": {\n \"min\": 164\n }\n },\n \"size\": 20,\n \"cursor\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fluximmo.io/v2/protected/opendata/dvf/search")
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 \"id\": \"2014-871319\",\n \"transaction_date\": {\n \"from\": \"2023-09-15\"\n },\n \"transaction_type\": [\n \"Vente\"\n ],\n \"price_eur\": {\n \"min\": 265788\n },\n \"price_per_m2_living_eur\": {\n \"min\": 3819\n },\n \"price_per_m2_land_eur\": {\n \"min\": 171\n },\n \"location\": {\n \"lat\": 48.8566,\n \"lon\": 2.3522,\n \"distance\": \"10km\"\n },\n \"departement_code\": \"83\",\n \"insee_code\": \"83137\",\n \"postal_code\": \"83000\",\n \"iris_code\": \"830680000\",\n \"iris_type\": [\n \"H\"\n ],\n \"property_type\": [\n \"Appartement\"\n ],\n \"surface_m2\": {\n \"min\": 476\n },\n \"main_rooms\": {\n \"min\": 3\n },\n \"land_surface_m2\": {\n \"min\": 1288\n },\n \"is_new_build\": false,\n \"is_open_market\": true,\n \"carrez_surface_m2\": {\n \"min\": 57.8\n },\n \"soil_surface_m2\": {\n \"min\": 185\n },\n \"garden_surface_m2\": {\n \"min\": 164\n }\n },\n \"size\": 20,\n \"cursor\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"data": [
{
"id": "2014-871319",
"transaction_date": "2023-09-15",
"transaction_type": "Vente",
"price_eur": 265788,
"price_per_m2_living_eur": 3819,
"price_per_m2_land_eur": 171,
"location": {
"lat": 48.8566,
"lon": 2.3522
},
"departement_code": "83",
"insee_code": "83137",
"postal_code": "83000",
"city_name": "<string>",
"street_number": "9001",
"street_name": "<string>",
"address": "<string>",
"iris_code": "830680000",
"iris_name": "<string>",
"iris_type": "H",
"property_type": "Appartement",
"surface_m2": 476,
"main_rooms": 3,
"transaction_class": "logement_sans_terrain",
"land_surface_m2": 1288,
"parcel_count": 1,
"housing_count": 1,
"house_count": 0,
"apartment_count": 0,
"outbuilding_count": 1,
"commercial_count": 0,
"is_new_build": false,
"is_open_market": true,
"carrez_surface_m2": 57.8,
"soil_surface_m2": 185,
"garden_surface_m2": 164
}
],
"total": 123,
"size": 123,
"hasMore": true,
"cursor": "<string>",
"from": 123
}{
"error": {
"message": "<string>",
"code": 123
}
}{
"error": {
"message": "<string>",
"code": 123
}
}À quoi ça sert
POST /v2/protected/opendata/dvf/search interroge la base DVF (Demandes de Valeurs Foncières), qui recense les transactions immobilières issues des actes notariés. Vous fournissez des filters (localisation, type de bien, type de mutation, fourchettes de prix et de surface, date) et l’endpoint retourne les mutations correspondantes, triées et paginées.
C’est un endpoint de recherche brute : il renvoie les transactions telles qu’elles existent dans DVF, sans scoring ni pondération. Si vous cherchez les ventes les plus comparables à un bien donné (avec un score de similarité), utilisez plutôt /dvf/match.
La pagination est par curseur : reprenez le champ cursor de la réponse pour obtenir la page suivante.
Payload
| Champ | Type | Obligatoire | Sens |
|---|---|---|---|
filters | objet | Non | Critères de recherche (voir ci-dessous). Sans filters, la recherche porte sur l’ensemble des transactions. |
sortBy | enum | Non | Champ de tri : id, transaction_date, price_eur, price_per_m2_living_eur, price_per_m2_land_eur, surface_m2. |
sortOrder | enum | Non | asc ou desc. |
size | integer | Non | Taille de page, entre 1 et 100 (défaut 20). |
cursor | string | Non | Curseur de pagination renvoyé par la réponse précédente. |
Champs de filters
| Champ | Type | Sens |
|---|---|---|
id | string | Identifiant unique d’une mutation DVF. |
transaction_date | { from, to } | Plage de dates (ISO). from = date minimale, to = date maximale ; les deux sont optionnelles. |
transaction_type | string[] | Nature de la mutation. Valeurs : Vente, Vente en l'etat futur d'achevement, Vente terrain a batir, Echange. |
price_eur | { min, max } | Fourchette du prix de transaction en euros. |
price_per_m2_living_eur | { min, max } | Fourchette du prix au m² de surface habitable. |
price_per_m2_land_eur | { min, max } | Fourchette du prix au m² de terrain. |
location | { lat, lon, distance } | Recherche géographique autour d’un point. distance au format 10km, 500m, 2mi, etc. Les trois champs sont requis ensemble. |
departement_code | string | Code département (2-3 caractères, ex : 75, 2A, 974). |
insee_code | string | Code INSEE de la commune (5 caractères). |
postal_code | string | Code postal (5 chiffres). |
iris_code | string | Code IRIS (9 chiffres). |
iris_type | string[] | Type d’IRIS : H (habitat), Z (zone), A (activité), D (divers). |
property_type | string[] | Type de bien : Appartement, Maison, Autre, Terrain, Tertiaire, Dépendance, Volume. |
surface_m2 | { min, max } | Fourchette de surface habitable principale en m². |
main_rooms | { min, max } | Fourchette du nombre de pièces principales. |
land_surface_m2 | { min, max } | Fourchette de surface de terrain en m². |
is_new_build | boolean | Logement neuf (VEFA ou première vente). |
is_open_market | boolean | Transaction sur le marché libre (hors adjudication/expropriation). |
carrez_surface_m2 | { min, max } | Fourchette de surface loi Carrez en m². |
soil_surface_m2 | { min, max } | Fourchette de surface au sol du bâti en m². |
garden_surface_m2 | { min, max } | Fourchette de surface de jardin en m². |
Réponse
L’API retourne une enveloppe paginée :| Champ | Type | Sens |
|---|---|---|
data | objet[] | Liste des mutations DVF correspondant aux filtres. |
total | integer | Nombre total de transactions correspondant à la recherche. |
size | integer | Taille de page effective. |
hasMore | boolean | true s’il reste des résultats à paginer. |
cursor | string | Curseur à réinjecter dans le champ cursor du payload pour la page suivante. |
data contient notamment id, transaction_date, transaction_type, price_eur, price_per_m2_living_eur, property_type, surface_m2, main_rooms, departement_code, insee_code, postal_code, location et is_new_build. Le contrat exact est documenté plus bas par le bloc OpenAPI.
Exemple
Appartements vendus à Toulon, du plus cher au moins cher
curl -X POST https://api.fluximmo.io/v2/protected/opendata/dvf/search \
-H "x-api-key: $FLUXIMMO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"filters": {
"departement_code": "83",
"postal_code": "83000",
"property_type": ["Appartement"],
"transaction_type": ["Vente"],
"transaction_date": { "from": "2023-01-01", "to": "2024-12-31" }
},
"sortBy": "price_eur",
"sortOrder": "desc",
"size": 5
}'
Appartements neufs en VEFA, triés par prix au m² habitable
curl -X POST https://api.fluximmo.io/v2/protected/opendata/dvf/search \
-H "x-api-key: $FLUXIMMO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"filters": {
"departement_code": "83",
"transaction_type": ["Vente en l'\''etat futur d'\''achevement"],
"is_new_build": true,
"property_type": ["Appartement"]
},
"sortBy": "price_per_m2_living_eur",
"sortOrder": "asc",
"size": 20
}'
La valeur
Vente en l'etat futur d'achevement contient deux apostrophes. En shell, échappez-les comme dans l’exemple ('\'') ou utilisez un fichier JSON via -d @payload.json.Recherche géographique autour d’un point
curl -X POST https://api.fluximmo.io/v2/protected/opendata/dvf/search \
-H "x-api-key: $FLUXIMMO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"filters": {
"location": { "lat": 43.1242, "lon": 5.928, "distance": "5km" },
"property_type": ["Maison"],
"surface_m2": { "min": 80, "max": 200 },
"price_eur": { "min": 200000, "max": 600000 }
},
"sortBy": "transaction_date",
"sortOrder": "desc",
"size": 10
}'
Liens utiles
- Match DVF à un bien immobilier — pour obtenir les transactions les plus comparables à un bien, avec score de similarité.
- DVF vs Fluximmo — différences entre les transactions notariées DVF et les annonces du marché Fluximmo.
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
Show child attributes
Show child attributes
Sort field
Available options:
id, transaction_date, price_eur, price_per_m2_living_eur, price_per_m2_land_eur, surface_m2 Sort order
Available options:
asc, desc Page size
Required range:
1 <= x <= 100Cursor for pagination
Was this page helpful?