ImmoScope API (2.0.0)

Ces APIs retourne des indicateurs de marché immobilier (trimestriels et mensuels pour certains) sur plusieurs échelles géographiques : France, région, département et ville. Elles offrent aussi la possibilité de comparer différentes périodes (mois-1 à mois-24, trimestre-1 à trimestre-8, année-1 et année-2)

Retourne les dernières périodes consolidées disponibles pour les indicateurs trimestriels et mensuels.

Authorizations:

ApiKeyAuth

Responses

Response samples

Content type

application/json

{"status": 200,
"data": ["dpe_mois_2024-12",
"dpe_trimestre_2024-04",
"mois_2025-10",
"trimestre_2025-03"
]
}

Retourne l'état des stocks des mandats de vente.

Authorizations:

ApiKeyAuth

query Parameters

type_bien	string Enum: "appartement" "maison" "tous" par défaut si valeur nulle appartement et maison
nb_pieces	integer uniquement si type_bien est appartement (si -1 toutes les tranches des pièces apparaîtront)
surface	integer uniquement si type_bien est maison (si -1 toutes les tranches des surfaces apparaîtront)
echelle_geo	string Enum: "france" "region" "departement" "ville" par défaut france
secteur_geo	string si echelle_geo france -> vide, region -> code region, departement -> code departement, ville -> code insee
periode	string Enum: "trimestre" "mois" par défaut trimestre
timelapse	string Value: "6 chiffres représentant un trimestre particulier)" permet de définir un trimestre particulier (ex 202301 pour le 1er trimestre 2023). Par défaut, le trimestre le plus récent disponible est sélectionné.
periode_compar	string Enum: "trimestre-1" "..." "trimestre-8" "mois-1" "..." "mois-24" "annee-1" "annee-2" si periode trimestre -> valeurs possibles de trimestre-1 à trimestre-8, annee-1, annee-2. si période mois -> valeurs possibles de mois-1 à mois-24.
milieu	string Enum: "rural" "intermediaire" "urbain" "tous" Important, cet indicateur ne peut être utilisé que si echelle_geo sélectionnée est departement.

Responses

Response samples

Content type

application/json

{"status": 200,
"search": {"type_bien": "tous",
"echelle_geo": "departement",
"secteur_geo": "29",
"periode": "trimestre"
},
"main_key": "nb_mandats",
"unit": [{"value": "number",
"variation": "percentage"
}
],
"data": [{"category": "trimestre_2025-03",
"values": [{"category": "bien_appartement",
"values": [{"key": "nb_mandats",
"value": 445,
"variation": -16.35
},
{"key": "nb_mandats_simples",
"value": 201,
"variation": -15.9
},
{"key": "nb_mandats_exclusifs",
"value": 139,
"variation": -20.57
}
]
},
{"category": "bien_tous",
"values": [{"key": "nb_mandats",
"value": 1529,
"variation": -18.45
},
{"key": "nb_mandats_simples",
"value": 740,
"variation": -23
},
{"key": "nb_mandats_exclusifs",
"value": 395,
"variation": -18.72
}
]
},
{"category": "bien_maison",
"values": [{"key": "nb_mandats",
"value": 1084,
"variation": -19.29
},
{"key": "nb_mandats_simples",
"value": 539,
"variation": -25.35
},
{"key": "nb_mandats_exclusifs",
"value": 256,
"variation": -17.68
}
]
}
]
}
]
}

Retourne les caractéristiques des bien recherchés selon le type de transaction (vente ou location).

Authorizations:

ApiKeyAuth

path Parameters

type_transaction

required

string

Enum: "vente" "location"

query Parameters

type_bien	string Enum: "appartement" "maison" "tous" par défaut si valeur nulle appartement et maison
echelle_geo	string Enum: "france" "region" "departement" "ville" par défaut france
secteur_geo	string si echelle_geo france -> vide, region -> code region, departement -> code departement, ville -> code insee
periode	string Value: "trimestre" par défaut trimestre
timelapse	string Value: "6 chiffres représentant un trimestre particulier)" permet de définir un trimestre particulier (ex 202301 pour le 1er trimestre 2023). Par défaut, le trimestre le plus récent disponible est sélectionné.
periode_compar	string Enum: "trimestre-1" "..." "trimestre-8" "annee-1" "annee-2" si periode trimestre -> valeurs possibles de trimestre-1 à trimestre-8, annee-1, annee-2.
milieu	string Enum: "rural" "intermediaire" "urbain" "tous" Important, cet indicateur ne peut être utilisé que si echelle_geo sélectionnée est departement.

Responses

Response samples

Content type

application/json

{"status": 200,
"search": {"type_bien": "tous",
"type_transaction": "vente",
"echelle_geo": "departement",
"secteur_geo": "29",
"periode": "trimestre"
},
"main_key": "prix_m2",
"unit": [{"key": ["surface"
],
"value": "surface"
},
{"key": ["prix",
"prix_m2"
],
"value": "currency",
"variation": "percentage"
},
{"value": "number",
"variation": "percentage"
}
],
"data": [{"category": "trimestre_2025-03",
"values": [{"category": "bien_appartement",
"values": [{"key": "nb_agences",
"value": 96
},
{"key": "nb_demandeurs",
"value": 1600
},
{"key": "nb_recherches",
"value": 1631,
"variation": 14.14
},
{"key": "surface",
"value": 60
},
{"key": "nb_pieces",
"value": 3
},
{"key": "prix",
"value": 159900
},
{"key": "prix_m2",
"value": 3000,
"min": 2143,
"max": 3875,
"variation": -12.74
}
]
},
{"category": "bien_tous",
"values": [{"key": "nb_agences",
"value": 124
},
{"key": "nb_demandeurs",
"value": 4828
},
{"key": "nb_recherches",
"value": 4910,
"variation": 13.87
},
{"key": "surface",
"value": 90
},
{"key": "nb_pieces",
"value": 4
},
{"key": "prix",
"value": 250000
},
{"key": "prix_m2",
"value": 3000,
"min": 2083,
"max": 4167,
"variation": -5.48
}
]
},
{"category": "bien_maison",
"values": [{"key": "nb_agences",
"value": 117
},
{"key": "nb_demandeurs",
"value": 3531
},
{"key": "nb_recherches",
"value": 3579,
"variation": 13.69
},
{"key": "surface",
"value": 100
},
{"key": "nb_pieces",
"value": 4
},
{"key": "prix",
"value": 290000
},
{"key": "prix_m2",
"value": 3024,
"min": 2083,
"max": 4181,
"variation": -4.73
}
]
}
]
}
]
}

Retourne le nombre de recherches selon le type de transaction (vente ou location).

Authorizations:

ApiKeyAuth

path Parameters

type_transaction

required

string

Enum: "vente" "location"

query Parameters

type_bien	string Enum: "appartement" "maison" "tous" par défaut si valeur nulle appartement et maison
echelle_geo	string Enum: "france" "region" "departement" "ville" par défaut france
secteur_geo	string si echelle_geo france -> vide, region -> code region, departement -> code departement, ville -> code insee
periode	string Enum: "trimestre" "mois" par défaut trimestre
timelapse	string Value: "6 chiffres représentant un trimestre particulier)" permet de définir un trimestre particulier (ex 202301 pour le 1er trimestre 2023). Par défaut, le trimestre le plus récent disponible est sélectionné.
periode_compar	string Enum: "trimestre-1" "..." "trimestre-8" "mois-1" "..." "mois-24" "annee-1" "annee-2" si periode trimestre -> valeurs possibles de trimestre-1 à trimestre-8, annee-1, annee-2. si période mois -> valeurs possibles de mois-1 à mois-24.
milieu	string Enum: "rural" "intermediaire" "urbain" "tous" Important, cet indicateur ne peut être utilisé que si echelle_geo sélectionnée est departement.

Responses

Response samples

Content type

application/json

{"status": 200,
"search": {"type_bien": "tous",
"type_transaction": "vente",
"echelle_geo": "departement",
"secteur_geo": "29",
"periode": "trimestre"
},
"main_key": "nb_recherches",
"unit": [{"value": "number",
"variation": "percentage"
}
],
"data": [{"category": "trimestre_2025-03",
"values": [{"category": "bien_appartement",
"values": [{"key": "nb_agences",
"value": 96
},
{"key": "nb_demandeurs",
"value": 1600,
"variation": 14.86
},
{"key": "nb_recherches",
"value": 1631,
"variation": 14.14
}
]
},
{"category": "bien_tous",
"values": [{"key": "nb_agences",
"value": 124
},
{"key": "nb_demandeurs",
"value": 4828,
"variation": 14.82
},
{"key": "nb_recherches",
"value": 4910,
"variation": 13.87
}
]
},
{"category": "bien_maison",
"values": [{"key": "nb_agences",
"value": 117
},
{"key": "nb_demandeurs",
"value": 3531,
"variation": 14.53
},
{"key": "nb_recherches",
"value": 3579,
"variation": 13.69
}
]
}
]
}
]
}

Retourne le type de bien selon le type de transaction (vente ou location).

Authorizations:

ApiKeyAuth

path Parameters

type_transaction

required

string

Enum: "vente" "location"

query Parameters

type_bien	string Enum: "appartement" "maison" "tous" par défaut si valeur nulle appartement et maison
dpe	string Enum: "A-E" "F-G" "tous" ne peut pas être utilisé simultanément avec le type_mandat
type_mandat	string Enum: "simple" "exclusif" "tous" ne peut pas être utilisé simultanément avec le dpe
echelle_geo	string Enum: "france" "region" "departement" "ville" par défaut france
secteur_geo	string si echelle_geo france -> vide, region -> code region, departement -> code departement, ville -> code insee
periode	string Value: "trimestre" par défaut trimestre
timelapse	string Value: "6 chiffres représentant un trimestre particulier)" permet de définir un trimestre particulier (ex 202301 pour le 1er trimestre 2023). Par défaut, le trimestre le plus récent disponible est sélectionné.
periode_compar	string Enum: "trimestre-1" "..." "trimestre-8" "annee-1" "annee-2" si periode trimestre -> valeurs possibles de trimestre-1 à trimestre-8, annee-1, annee-2.
milieu	string Enum: "rural" "intermediaire" "urbain" "tous" Important, cet indicateur ne peut être utilisé que si echelle_geo sélectionnée est departement.

Responses

Response samples

Content type

application/json

{"status": 200,
"search": {"type_bien": "tous",
"type_transaction": "vente",
"type_mandat": "tous",
"echelle_geo": "departement",
"secteur_geo": "29",
"periode": "trimestre"
},
"main_key": "prix_m2",
"unit": [{"key": ["surface"
],
"value": "surface"
},
{"key": ["prix",
"prix_m2"
],
"value": "currency",
"variation": "percentage"
},
{"value": "number",
"variation": "percentage"
}
],
"data": [{"category": "trimestre_2025-03",
"values": [{"category": "bien_appartement",
"values": [{"category": "mandat_exclusif",
"values": [{"key": "nb_agences",
"value": 29
},
{"key": "nb_compromis",
"value": 78
},
{"key": "prix",
"value": 146124
},
{"key": "surface",
"value": 54
},
{"key": "nb_pieces",
"value": 3
},
{"key": "prix_m2",
"value": 2706,
"min": 1958,
"max": 3103,
"variation": 4.04
}
]
},
{"category": "mandat_simple",
"values": [{"key": "nb_agences",
"value": 32
},
{"key": "nb_compromis",
"value": 64
},
{"key": "prix",
"value": 164989
},
{"key": "surface",
"value": 53
},
{"key": "nb_pieces",
"value": 2
},
{"key": "prix_m2",
"value": 3113,
"min": 2384,
"max": 3768,
"variation": 7.68
}
]
},
{"category": "mandat_tous",
"values": [{"key": "nb_agences",
"value": 53
},
{"key": "nb_compromis",
"value": 166
},
{"key": "prix",
"value": 136400
},
{"key": "surface",
"value": 54
},
{"key": "nb_pieces",
"value": 3
},
{"key": "prix_m2",
"value": 2742,
"min": 2146,
"max": 3477,
"variation": 5.83
}
]
}
]
},
{"category": "bien_maison",
"values": [{"category": "mandat_exclusif",
"values": [{"key": "nb_agences",
"value": 45
},
{"key": "nb_compromis",
"value": 111
},
{"key": "prix",
"value": 241500
},
{"key": "surface",
"value": 110
},
{"key": "nb_pieces",
"value": 6
},
{"key": "prix_m2",
"value": 2353,
"min": 1771,
"max": 2870,
"variation": -1.22
}
]
},
{"category": "mandat_simple",
"values": [{"key": "nb_agences",
"value": 65
},
{"key": "nb_compromis",
"value": 171
},
{"key": "prix",
"value": 273650
},
{"key": "surface",
"value": 117
},
{"key": "nb_pieces",
"value": 6
},
{"key": "prix_m2",
"value": 2461,
"min": 1991,
"max": 3022,
"variation": -0.81
}
]
},
{"category": "mandat_tous",
"values": [{"key": "nb_agences",
"value": 76
},
{"key": "nb_compromis",
"value": 322
},
{"key": "prix",
"value": 269850
},
{"key": "surface",
"value": 116
},
{"key": "nb_pieces",
"value": 6
},
{"key": "prix_m2",
"value": 2402,
"min": 1898,
"max": 2992,
"variation": 1.05
}
]
}
]
},
{"category": "bien_tous",
"values": [{"category": "mandat_exclusif",
"values": [{"key": "nb_agences",
"value": 55
},
{"key": "nb_compromis",
"value": 189
},
{"key": "prix",
"value": 178000
},
{"key": "surface",
"value": 85
},
{"key": "nb_pieces",
"value": 4
},
{"key": "prix_m2",
"value": 2462,
"min": 1871,
"max": 2922,
"variation": 2.84
}
]
},
{"category": "mandat_simple",
"values": [{"key": "nb_agences",
"value": 68
},
{"key": "nb_compromis",
"value": 235
},
{"key": "prix",
"value": 254450
},
{"key": "surface",
"value": 106
},
{"key": "nb_pieces",
"value": 5
},
{"key": "prix_m2",
"value": 2600,
"min": 2077,
"max": 3201,
"variation": 2.44
}
]
},
{"category": "mandat_tous",
"values": [{"key": "nb_agences",
"value": 84
},
{"key": "nb_compromis",
"value": 488
},
{"key": "prix",
"value": 213000
},
{"key": "surface",
"value": 99
},
{"key": "nb_pieces",
"value": 5
},
{"key": "prix_m2",
"value": 2513,
"min": 1958,
"max": 3132,
"variation": 3.37
}
]
}
]
}
]
}
]
}

Retourne l'évolution du nombre de compromis signés.

Authorizations:

ApiKeyAuth

query Parameters

type_bien	string Enum: "appartement" "maison" "tous" par défaut si valeur nulle appartement et maison
nb_pieces	integer uniquement si type_bien est appartement (si -1 toutes les tranches des pièces apparaîtront)
surface	integer uniquement si type_bien est maison (si -1 toutes les tranches des surfaces apparaîtront)
dpe	string Enum: "A-E" "F-G" "tous"
echelle_geo	string Enum: "france" "region" "departement" "ville" par défaut france
secteur_geo	string si echelle_geo france -> vide, region -> code region, departement -> code departement, ville -> code insee
periode	string Enum: "trimestre" "mois" par défaut trimestre
timelapse	string Value: "6 chiffres représentant un trimestre particulier)" permet de définir un trimestre particulier (ex 202301 pour le 1er trimestre 2023). Par défaut, le trimestre le plus récent disponible est sélectionné.
periode_compar	string Enum: "trimestre-1" "..." "trimestre-8" "mois-1" "..." "mois-24" "annee-1" "annee-2" si periode trimestre -> valeurs possibles de trimestre-1 à trimestre-8, annee-1, annee-2. si période mois -> valeurs possibles de mois-1 à mois-24.
milieu	string Enum: "rural" "intermediaire" "urbain" "tous" Important, cet indicateur ne peut être utilisé que si echelle_geo sélectionnée est departement.

Responses

Response samples

Content type

application/json

{"status": 200,
"search": {"type_bien": "tous",
"echelle_geo": "departement",
"secteur_geo": "29",
"periode": "trimestre"
},
"main_key": "variation_nb_compromis",
"unit": [{"value": "percentage",
"variation": "points"
}
],
"data": [{"category": "trimestre_2025-03",
"values": [{"category": "bien_appartement",
"values": [{"key": "variation_nb_compromis",
"value": -7.82,
"variation": 6.94
}
]
},
{"category": "bien_tous",
"values": [{"key": "variation_nb_compromis",
"value": -10.58,
"variation": -3.11
}
]
},
{"category": "bien_maison",
"values": [{"key": "variation_nb_compromis",
"value": -12.02,
"variation": -8.89
}
]
}
]
}
]
}

Retourne l'évolution du nombre de baux signés.

Authorizations:

ApiKeyAuth

query Parameters

type_bien	string Enum: "appartement" "maison" "tous" par défaut si valeur nulle appartement et maison
nb_pieces	integer uniquement si type_bien est appartement (si -1 toutes les tranches des pièces apparaîtront)
surface	integer uniquement si type_bien est maison (si -1 toutes les tranches des surfaces apparaîtront)
dpe	string Enum: "A-E" "F-G" "tous"
echelle_geo	string Enum: "france" "region" "departement" "ville" par défaut france
secteur_geo	string si echelle_geo france -> vide, region -> code region, departement -> code departement, ville -> code insee
periode	string Enum: "trimestre" "mois" par défaut trimestre
timelapse	string Value: "6 chiffres représentant un trimestre particulier)" permet de définir un trimestre particulier (ex 202301 pour le 1er trimestre 2023). Par défaut, le trimestre le plus récent disponible est sélectionné.
periode_compar	string Enum: "trimestre-1" "..." "trimestre-8" "mois-1" "..." "mois-24" "annee-1" "annee-2" si periode trimestre -> valeurs possibles de trimestre-1 à trimestre-8, annee-1, annee-2. si période mois -> valeurs possibles de mois-1 à mois-24.
milieu	string Enum: "rural" "intermediaire" "urbain" "tous" Important, cet indicateur ne peut être utilisé que si echelle_geo sélectionnée est departement.

Responses

Response samples

Content type

application/json

{"status": 200,
"search": {"type_bien": "tous",
"echelle_geo": "departement",
"secteur_geo": "29",
"periode": "mois"
},
"main_key": "variation_nb_baux",
"unit": [{"value": "percentage",
"variation": "points"
}
],
"data": [{"category": "mtrimestre_2025-03",
"values": [{"category": "bien_appartement",
"values": [{"key": "variation_nb_baux",
"value": 8.18,
"variation": -1.02
}
]
},
{"category": "bien_tous",
"values": [{"key": "variation_nb_baux",
"value": -2.01,
"variation": 0.82
}
]
},
{"category": "bien_maison",
"values": [{"key": "variation_nb_baux",
"value": -3.21,
"variation": -1.51
}
]
}
]
}
]
}

Retourne le nombre de jours de délai d'une vente.

Authorizations:

ApiKeyAuth

query Parameters

type_bien	string Enum: "appartement" "maison" "tous" par défaut si valeur nulle appartement et maison
type_mandat	string Enum: "simple" "exclusif" "tous"
echelle_geo	string Enum: "france" "region" "departement" "ville" par défaut france
secteur_geo	string si echelle_geo france -> vide, region -> code region, departement -> code departement, ville -> code insee
periode	string Value: "trimestre" par défaut trimestre
timelapse	string Value: "6 chiffres représentant un trimestre particulier)" permet de définir un trimestre particulier (ex 202301 pour le 1er trimestre 2023). Par défaut, le trimestre le plus récent disponible est sélectionné.
periode_compar	string Enum: "trimestre-1" "..." "trimestre-8" "annee-1" "annee-2" si periode trimestre -> valeurs possibles de trimestre-1 à trimestre-8, annee-1, annee-2.
milieu	string Enum: "rural" "intermediaire" "urbain" "tous" Important, cet indicateur ne peut être utilisé que si echelle_geo sélectionnée est departement.

Responses

Response samples

Content type

application/json

{"status": 200,
"search": {"type_bien": "tous",
"type_mandat": "tous",
"echelle_geo": "departement",
"secteur_geo": "29",
"periode": "trimestre"
},
"main_key": "delai",
"unit": [{"value": "day",
"variation": "day"
}
],
"data": [{"category": "trimestre_2025-03",
"values": [{"category": "bien_appartement",
"values": [{"category": "mandat_exclusif",
"values": [{"key": "nb_agences",
"value": 29
},
{"key": "nb_compromis",
"value": 78
},
{"key": "delai",
"value": 81,
"min": 42,
"max": 136,
"variation": 13
}
]
},
{"category": "mandat_simple",
"values": [{"key": "nb_agences",
"value": 32
},
{"key": "nb_compromis",
"value": 64
},
{"key": "delai",
"value": 111,
"min": 53,
"max": 196,
"variation": 51
}
]
},
{"category": "mandat_tous",
"values": [{"key": "nb_agences",
"value": 53
},
{"key": "nb_compromis",
"value": 166
},
{"key": "delai",
"value": 82,
"min": 43,
"max": 150,
"variation": 22
}
]
}
]
},
{"category": "bien_maison",
"values": [{"category": "mandat_exclusif",
"values": [{"key": "nb_agences",
"value": 45
},
{"key": "nb_compromis",
"value": 111
},
{"key": "delai",
"value": 102,
"min": 56,
"max": 158,
"variation": 32
}
]
},
{"category": "mandat_simple",
"values": [{"key": "nb_agences",
"value": 65
},
{"key": "nb_compromis",
"value": 171
},
{"key": "delai",
"value": 93,
"min": 49,
"max": 154,
"variation": 8
}
]
},
{"category": "mandat_tous",
"values": [{"key": "nb_agences",
"value": 76
},
{"key": "nb_compromis",
"value": 322
},
{"key": "delai",
"value": 98,
"min": 54,
"max": 156,
"variation": 24
}
]
}
]
},
{"category": "bien_tous",
"values": [{"category": "mandat_exclusif",
"values": [{"key": "nb_agences",
"value": 55
},
{"key": "nb_compromis",
"value": 189
},
{"key": "delai",
"value": 89,
"min": 46,
"max": 150,
"variation": 19
}
]
},
{"category": "mandat_simple",
"values": [{"key": "nb_agences",
"value": 68
},
{"key": "nb_compromis",
"value": 235
},
{"key": "delai",
"value": 96,
"min": 51,
"max": 162,
"variation": 14
}
]
},
{"category": "mandat_tous",
"values": [{"key": "nb_agences",
"value": 84
},
{"key": "nb_compromis",
"value": 488
},
{"key": "delai",
"value": 90,
"min": 49,
"max": 154,
"variation": 20
}
]
}
]
}
]
}
]
}

Retourne le pourcentage de négociation entre le dernier prix et le prix de vente.

Authorizations:

ApiKeyAuth

query Parameters

type_bien	string Enum: "appartement" "maison" "tous" par défaut si valeur nulle appartement et maison
echelle_geo	string Enum: "france" "region" "departement" "ville" par défaut france
secteur_geo	string si echelle_geo france -> vide, region -> code region, departement -> code departement, ville -> code insee
type_mandat	string Enum: "simple" "exclusif" "tous"
periode	string Value: "trimestre" par défaut trimestre
timelapse	string Value: "6 chiffres représentant un trimestre particulier)" permet de définir un trimestre particulier (ex 202301 pour le 1er trimestre 2023). Par défaut, le trimestre le plus récent disponible est sélectionné.
periode_compar	string Enum: "trimestre-1" "..." "trimestre-8" "annee-1" "annee-2" si periode trimestre -> valeurs possibles de trimestre-1 à trimestre-8, annee-1, annee-2.
milieu	string Enum: "rural" "intermediaire" "urbain" "tous" Important, cet indicateur ne peut être utilisé que si echelle_geo sélectionnée est departement.

Responses

Response samples

Content type

application/json

{"status": 200,
"search": {"type_bien": "tous",
"echelle_geo": "departement",
"secteur_geo": "29",
"periode": "trimestre",
"type_mandat": "tous"
},
"main_key": "marge_nego",
"unit": [{"value": "percentage",
"variation": "points"
}
],
"data": [{"category": "trimestre_2025-03",
"values": [{"category": "bien_appartement",
"values": [{"category": "mandat_exclusif",
"values": [{"key": "nb_agences",
"value": 22
},
{"key": "nb_compromis",
"value": 50
},
{"key": "marge_nego",
"value": 6.61,
"min": 3.04,
"max": 8.97,
"variation": 1.95
}
]
},
{"category": "mandat_simple",
"values": [{"key": "nb_agences",
"value": 18
},
{"key": "nb_compromis",
"value": 32
},
{"key": "marge_nego",
"value": 5.41,
"min": 3.62,
"max": 8.4,
"variation": 0.37
}
]
},
{"category": "mandat_tous",
"values": [{"key": "nb_agences",
"value": 31
},
{"key": "nb_compromis",
"value": 89
},
{"key": "marge_nego",
"value": 5.78,
"min": 3.57,
"max": 8.67,
"variation": 1.02
}
]
}
]
},
{"category": "bien_maison",
"values": [{"category": "mandat_exclusif",
"values": [{"key": "nb_agences",
"value": 29
},
{"key": "nb_compromis",
"value": 61
},
{"key": "marge_nego",
"value": 6.18,
"min": 3.96,
"max": 10.41,
"variation": 1
}
]
},
{"category": "mandat_simple",
"values": [{"key": "nb_agences",
"value": 45
},
{"key": "nb_compromis",
"value": 98
},
{"key": "marge_nego",
"value": 6.47,
"min": 3.46,
"max": 9.45,
"variation": 1.07
}
]
},
{"category": "mandat_tous",
"values": [{"key": "nb_agences",
"value": 55
},
{"key": "nb_compromis",
"value": 176
},
{"key": "marge_nego",
"value": 6.16,
"min": 3.44,
"max": 10,
"variation": 1.07
}
]
}
]
},
{"category": "bien_tous",
"values": [{"category": "mandat_exclusif",
"values": [{"key": "nb_agences",
"value": 37
},
{"key": "nb_compromis",
"value": 111
},
{"key": "marge_nego",
"value": 6.23,
"min": 3.7,
"max": 9.8,
"variation": 1.21
}
]
},
{"category": "mandat_simple",
"values": [{"key": "nb_agences",
"value": 47
},
{"key": "nb_compromis",
"value": 132
},
{"key": "marge_nego",
"value": 6,
"min": 3.36,
"max": 9.18,
"variation": 0.82
}
]
},
{"category": "mandat_tous",
"values": [{"key": "nb_agences",
"value": 62
},
{"key": "nb_compromis",
"value": 266
},
{"key": "marge_nego",
"value": 6.1,
"min": 3.48,
"max": 9.44,
"variation": 1.07
}
]
}
]
}
]
}
]
}

Retourne la baisse de prix entre le premier prix et le prix de vente.

Authorizations:

ApiKeyAuth

query Parameters

type_bien	string Enum: "appartement" "maison" "tous" par défaut si valeur nulle appartement et maison
echelle_geo	string Enum: "france" "region" "departement" "ville" par défaut france
secteur_geo	string si echelle_geo france -> vide, region -> code region, departement -> code departement, ville -> code insee
periode	string Value: "trimestre" par défaut trimestre
timelapse	string Value: "6 chiffres représentant un trimestre particulier)" permet de définir un trimestre particulier (ex 202301 pour le 1er trimestre 2023). Par défaut, le trimestre le plus récent disponible est sélectionné.
periode_compar	string Enum: "trimestre-1" "..." "trimestre-8" "annee-1" "annee-2" si periode trimestre -> valeurs possibles de trimestre-1 à trimestre-8, annee-1, annee-2.
milieu	string Enum: "rural" "intermediaire" "urbain" "tous" Important, cet indicateur ne peut être utilisé que si echelle_geo sélectionnée est departement.

Responses

Response samples

Content type

application/json

{"status": 200,
"search": {"type_bien": "tous",
"echelle_geo": "departement",
"secteur_geo": "29",
"periode": "trimestre"
},
"main_key": "baisse_prix",
"unit": [{"value": "percentage",
"variation": "points"
}
],
"data": [{"category": "trimestre_2025-03",
"values": [{"category": "bien_appartement",
"values": [{"key": "nb_agences",
"value": 41
},
{"key": "nb_compromis",
"value": 103
},
{"key": "baisse_prix",
"value": 7.65,
"min": 4.79,
"max": 13.15,
"variation": 0.62
}
]
},
{"category": "bien_tous",
"values": [{"key": "nb_agences",
"value": 74
},
{"key": "nb_compromis",
"value": 317
},
{"key": "baisse_prix",
"value": 8.46,
"min": 4.73,
"max": 15.37,
"variation": 1.04
}
]
},
{"category": "bien_maison",
"values": [{"key": "nb_agences",
"value": 65
},
{"key": "nb_compromis",
"value": 212
},
{"key": "baisse_prix",
"value": 8.97,
"min": 4.77,
"max": 15.68,
"variation": 1.26
}
]
}
]
}
]
}

Retourne le nombre de jours entre la signature de deux baux pour une location et le nombre de mois entre la signature de deux compromis pour une vente.

Authorizations:

ApiKeyAuth

path Parameters

type_transaction

required

string

Enum: "vente" "location"

query Parameters

type_bien	string Enum: "appartement" "maison" "tous" par défaut si valeur nulle appartement et maison
nb_pieces	integer uniquement si type_bien est appartement (si -1 toutes les tranches des pièces apparaîtront)
surface	integer uniquement si type_bien est maison (si -1 toutes les tranches des surfaces apparaîtront)
echelle_geo	string Enum: "france" "region" "departement" "ville" par défaut france
secteur_geo	string si echelle_geo france -> vide, region -> code region, departement -> code departement, ville -> code insee
periode	string Value: "trimestre" par défaut trimestre
timelapse	string Value: "6 chiffres représentant un trimestre particulier)" permet de définir un trimestre particulier (ex 202301 pour le 1er trimestre 2023). Par défaut, le trimestre le plus récent disponible est sélectionné.
periode_compar	string Enum: "trimestre-1" "..." "trimestre-8" "annee-1" "annee-2" si periode trimestre -> valeurs possibles de trimestre-1 à trimestre-8, annee-1, annee-2.
milieu	string Enum: "rural" "intermediaire" "urbain" "tous" Important, cet indicateur ne peut être utilisé que si echelle_geo sélectionnée est departement.

Responses

Response samples

Content type

application/json

{"status": 200,
"search": {"type_bien": "tous",
"type_transaction": "vente",
"echelle_geo": "departement",
"secteur_geo": "29",
"periode": "trimestre"
},
"main_key": "nb_mois_entre_mutation",
"unit": [{"value": "month",
"variation": "month"
}
],
"data": [{"category": "trimestre_2025-03",
"values": [{"category": "bien_tous",
"values": [{"key": "nb_compromis",
"value": 1286
},
{"key": "nb_mois_entre_mutation",
"value": 46,
"variation": 3
}
]
},
{"category": "bien_appartement",
"values": [{"key": "nb_compromis",
"value": 706
},
{"key": "nb_mois_entre_mutation",
"value": 37,
"variation": 4
}
]
},
{"category": "bien_maison",
"values": [{"key": "nb_compromis",
"value": 580
},
{"key": "nb_mois_entre_mutation",
"value": 54,
"variation": -1
}
]
}
]
}
]
}

Retourne le taux de transformation des mandats en compromis.

Authorizations:

ApiKeyAuth

query Parameters

type_bien	string Enum: "appartement" "maison" "tous" par défaut si valeur nulle appartement et maison
type_mandat	string Enum: "simple" "exclusif" "tous"
echelle_geo	string Enum: "france" "region" "departement" "ville" par défaut france
secteur_geo	string si echelle_geo france -> vide, region -> code region, departement -> code departement, ville -> code insee
periode	string Value: "trimestre" par défaut trimestre
timelapse	string Value: "6 chiffres représentant un trimestre particulier)" permet de définir un trimestre particulier (ex 202301 pour le 1er trimestre 2023). Par défaut, le trimestre le plus récent disponible est sélectionné.
periode_compar	string Enum: "trimestre-1" "..." "trimestre-8" "annee-1" "annee-2" si periode trimestre -> valeurs possibles de trimestre-1 à trimestre-8, annee-1, annee-2.
milieu	string Enum: "rural" "intermediaire" "urbain" "tous" Important, cet indicateur ne peut être utilisé que si echelle_geo sélectionnée est departement.

Responses

Response samples

Content type

application/json

{"status": 200,
"search": {"type_bien": "tous",
"echelle_geo": "departement",
"secteur_geo": "29",
"periode": "trimestre",
"type_mandat": "tous"
},
"main_key": "tx_transfo",
"unit": [{"value": "percentage",
"variation": "points"
}
],
"data": [{"category": "trimestre_2025-03",
"values": [{"category": "bien_appartement",
"values": [{"category": "mandat_exclusif",
"values": [{"key": "nb_agences",
"value": 21
},
{"key": "nb_compromis",
"value": 57
},
{"key": "tx_transfo",
"value": 32.57,
"variation": -6.81
}
]
},
{"category": "mandat_simple",
"values": [{"key": "nb_agences",
"value": 19
},
{"key": "nb_compromis",
"value": 30
},
{"key": "tx_transfo",
"value": 12.55,
"variation": -5.23
}
]
},
{"category": "mandat_tous",
"values": [{"key": "nb_agences",
"value": 31
},
{"key": "nb_compromis",
"value": 99
},
{"key": "tx_transfo",
"value": 18.61,
"variation": -3.51
}
]
}
]
},
{"category": "bien_maison",
"values": [{"category": "mandat_exclusif",
"values": [{"key": "nb_agences",
"value": 34
},
{"key": "nb_compromis",
"value": 87
},
{"key": "tx_transfo",
"value": 29.97,
"variation": -2.85
}
]
},
{"category": "mandat_simple",
"values": [{"key": "nb_agences",
"value": 48
},
{"key": "nb_compromis",
"value": 106
},
{"key": "tx_transfo",
"value": 14.68,
"variation": 3.82
}
]
},
{"category": "mandat_tous",
"values": [{"key": "nb_agences",
"value": 64
},
{"key": "nb_compromis",
"value": 224
},
{"key": "tx_transfo",
"value": 16.68,
"variation": 2.6
}
]
}
]
},
{"category": "bien_tous",
"values": [{"category": "mandat_exclusif",
"values": [{"key": "nb_agences",
"value": 46
},
{"key": "nb_compromis",
"value": 144
},
{"key": "tx_transfo",
"value": 29.63,
"variation": -4.22
}
]
},
{"category": "mandat_simple",
"values": [{"key": "nb_agences",
"value": 54
},
{"key": "nb_compromis",
"value": 136
},
{"key": "tx_transfo",
"value": 14.15,
"variation": 1.54
}
]
},
{"category": "mandat_tous",
"values": [{"key": "nb_agences",
"value": 73
},
{"key": "nb_compromis",
"value": 323
},
{"key": "tx_transfo",
"value": 17.23,
"variation": 0.81
}
]
}
]
}
]
}
]
}

Retourne le nombre de biens selon leur DPE.

Authorizations:

ApiKeyAuth

query Parameters

type_bien	string Enum: "appartement" "maison" "tous" si valeur tous alors surface doit être nulle ou -1 (toutes les tranches des surfaces apparaîtront)
surface	integer si type_bien = tous alors surface doit être nulle ou -1 (toutes les tranches des surfaces apparaîtront)
dpe	string Enum: "A" "B" "C" "D" "E" "F" "G" "tous"
echelle_geo	string Enum: "france" "region" "departement" "ville" par défaut france
secteur_geo	string si echelle_geo france -> vide, region -> code region, departement -> code departement, ville -> code insee
periode	string Enum: "trimestre" "mois" par défaut trimestre
timelapse	string Value: "6 chiffres représentant un trimestre particulier)" permet de définir un trimestre particulier (ex 202301 pour le 1er trimestre 2023). Par défaut, le trimestre le plus récent disponible est sélectionné.
periode_compar	string Enum: "trimestre-1" "..." "trimestre-8" "mois-1" "..." "mois-24" "annee-1" "annee-2" si periode trimestre -> valeurs possibles de trimestre-1 à trimestre-8, annee-1, annee-2. si période mois -> valeurs possibles de mois-1 à mois-24.
milieu	string Enum: "rural" "intermediaire" "urbain" "tous" Important, cet indicateur ne peut être utilisé que si echelle_geo sélectionnée est departement.

Responses

Response samples

Content type

application/json

{"status": 200,
"search": {"type_bien": "tous",
"dpe": "D",
"echelle_geo": "departement",
"secteur_geo": "29",
"periode": "trimestre"
},
"main_key": "nb_dpe",
"unit": [{"value": "number",
"variation": "percentage"
}
],
"data": [{"category": "trimestre_2025-03",
"values": [{"category": "bien_appartement",
"values": [{"category": "dpe_D",
"values": [{"key": "nb_dpe",
"value": 1232,
"variation": 8.64
}
]
}
]
},
{"category": "bien_maison",
"values": [{"category": "dpe_D",
"values": [{"key": "nb_dpe",
"value": 1158,
"variation": 8.12
}
]
}
]
},
{"category": "bien_tous",
"values": [{"category": "dpe_D",
"values": [{"key": "nb_dpe",
"value": 2390,
"variation": 4.22
}
]
}
]
}
]
}
]
}

Retourne l'évolution du nombre d'annonces publiées (vente ou location).

Authorizations:

ApiKeyAuth

path Parameters

type_transaction

required

string

Enum: "vente" "location"

query Parameters

type_bien	string Enum: "appartement" "maison" "tous" par défaut si valeur nulle appartement et maison
nb_pieces	integer uniquement si type_bien est appartement (si -1 toutes les tranches des pièces apparaîtront)
surface	integer uniquement si type_bien est maison (si -1 toutes les tranches des surfaces apparaîtront)
type_vendeur	string Enum: "professionnel" "particulier" "tous" ne peut pas être utilisé simultanément avec le type_mandat
type_mandat	string Enum: "simple" "exclusif" "tous" ne peut pas être utilisé simultanément avec le type_vendeur
echelle_geo	string Enum: "france" "region" "departement" "ville" par défaut france
secteur_geo	string si echelle_geo france -> vide, region -> code region, departement -> code departement, ville -> code insee
periode	string Enum: "trimestre" "mois" par défaut trimestre
timelapse	string Value: "6 chiffres représentant un trimestre ou un mois particulier)" permet de définir un trimestre/mois particulier (ex 202501 pour le 1er trimestre 2025). Par défaut, le trimestre ou le mois le plus récent disponible est sélectionné.
periode_compar	string Enum: "trimestre-1" "..." "trimestre-8" "annee-1" "annee-2" si periode trimestre -> valeurs possibles de trimestre-1 à trimestre-8, annee-1, annee-2.
milieu	string Enum: "rural" "intermediaire" "urbain" "tous" Important, cet indicateur ne peut être utilisé que si echelle_geo sélectionnée est departement.

Responses

Response samples

Content type

application/json

{"status": 200,
"search": {"type_bien": "tous",
"type_transaction": "vente",
"echelle_geo": "departement",
"secteur_geo": "29",
"periode": "trimestre"
},
"main_key": "variation_nb_publications",
"unit": [{"value": "percentage",
"variation": "points"
}
],
"data": [{"category": "trimestre_2024-04",
"values": [{"category": "bien_appartement",
"values": [{"category": "vendeur_particulier",
"values": [{"key": "variation_nb_publications",
"value": -9.85,
"variation": -17.83
}
]
},
{"category": "vendeur_professionnel",
"values": [{"key": "variation_nb_publications",
"value": -9.85,
"variation": -17.83
}
]
},
{"category": "vendeur_tous",
"values": [{"key": "variation_nb_publications",
"value": -9.85,
"variation": -17.83
}
]
}
]
},
{"category": "bien_maison",
"values": [{"category": "vendeur_particulier",
"values": [{"key": "variation_nb_publications",
"value": -9.85,
"variation": -17.83
}
]
},
{"category": "vendeur_professionnel",
"values": [{"key": "variation_nb_publications",
"value": -9.85,
"variation": -17.83
}
]
},
{"category": "vendeur_tous",
"values": [{"key": "variation_nb_publications",
"value": -9.85,
"variation": -17.83
}
]
}
]
}
]
}
]
}

Durée médiane de diffusion d'annonces sur les portails (vente ou location).

Authorizations:

ApiKeyAuth

path Parameters

type_transaction

required

string

Enum: "vente" "location"

query Parameters

type_bien	string Enum: "appartement" "maison" "tous" par défaut si valeur nulle appartement et maison
type_vendeur	string Enum: "professionnel" "particulier" "tous" ne peut pas être utilisé simultanément avec le type_mandat
type_mandat	string Enum: "simple" "exclusif" "tous" ne peut pas être utilisé simultanément avec le type_vendeur
echelle_geo	string Enum: "france" "region" "departement" "ville" par défaut france
secteur_geo	string si echelle_geo france -> vide, region -> code region, departement -> code departement, ville -> code insee
periode	string Value: "trimestre" par défaut trimestre
timelapse	string Value: "6 chiffres représentant un trimestre particulier)" permet de définir un trimestre particulier (ex 202501 pour le 1er trimestre 2025). Par défaut, le trimestre le plus récent disponible est sélectionné.
periode_compar	string Enum: "trimestre-1" "..." "trimestre-8" "annee-1" "annee-2" valeurs possibles de trimestre-1 à trimestre-8, annee-1, annee-2.
milieu	string Enum: "rural" "intermediaire" "urbain" "tous" Important, cet indicateur ne peut être utilisé que si echelle_geo sélectionnée est departement.

Responses

Response samples

Content type

application/json

{"status": 200,
"search": {"type_bien": "tous",
"type_transaction": "vente",
"echelle_geo": "departement",
"secteur_geo": "29",
"periode": "trimestre"
},
"main_key": "duree_publication",
"unit": [{"value": "day",
"variation": "day"
}
],
"data": [{"category": "trimestre_2024-04",
"values": [{"category": "bien_appartement",
"values": [{"category": "vendeur_particulier",
"values": [{"key": "nb_annonces",
"value": 120
},
{"key": "duree_publication",
"value": 66,
"min": 38,
"max": 128,
"variation": 4
}
]
},
{"category": "vendeur_professionnel",
"values": [{"key": "nb_annonces",
"value": 1776
},
{"key": "duree_publication",
"value": 62,
"min": 26,
"max": 112,
"variation": -10
}
]
},
{"category": "vendeur_tous",
"values": [{"key": "nb_annonces",
"value": 1896
},
{"key": "duree_publication",
"value": 62,
"min": 27,
"max": 115,
"variation": -9
}
]
}
]
},
{"category": "bien_maison",
"values": [{"category": "vendeur_particulier",
"values": [{"key": "nb_annonces",
"value": 305
},
{"key": "duree_publication",
"value": 66,
"min": 32,
"max": 148,
"variation": -2
}
]
},
{"category": "vendeur_professionnel",
"values": [{"key": "nb_annonces",
"value": 3817
},
{"key": "duree_publication",
"value": 74,
"min": 34,
"max": 138,
"variation": -7
}
]
},
{"category": "vendeur_tous",
"values": [{"key": "nb_annonces",
"value": 4121
},
{"key": "duree_publication",
"value": 74,
"min": 34,
"max": 138,
"variation": -6
}
]
}
]
},
{"category": "bien_tous",
"values": [{"category": "vendeur_particulier",
"values": [{"key": "nb_annonces",
"value": 425
},
{"key": "duree_publication",
"value": 66,
"min": 35,
"max": 140,
"variation": -41
}
]
},
{"category": "vendeur_professionnel",
"values": [{"key": "nb_annonces",
"value": 5596
},
{"key": "duree_publication",
"value": 69,
"min": 32,
"max": 129,
"variation": -8
}
]
},
{"category": "vendeur_tous",
"values": [{"key": "nb_annonces",
"value": 6018
},
{"key": "duree_publication",
"value": 69,
"min": 32,
"max": 130,
"variation": -7
}
]
}
]
}
]
}
]
}

Retourne la baisse de prix médiane enregistrée en fonction de la durée de publication des annonces de vente.

Authorizations:

ApiKeyAuth

query Parameters

type_bien	string Enum: "appartement" "maison" "tous" par défaut si valeur nulle appartement et maison
duree_publication	string Enum: "-30" "30" "tous" découpage par durée de publication (-30 -> moins de 30 jours, 30 -> plus de 30 jours, tous -> toutes les durées)
type_vendeur	string Enum: "professionnel" "particulier" "tous" ne peut pas être utilisé simultanément avec le type_mandat
type_mandat	string Enum: "simple" "exclusif" "tous" ne peut pas être utilisé simultanément avec le type_vendeur
echelle_geo	string Enum: "france" "region" "departement" "ville" par défaut france
secteur_geo	string si echelle_geo france -> vide, region -> code region, departement -> code departement, ville -> code insee
periode	string Value: "trimestre" par défaut trimestre
timelapse	string Value: "6 chiffres représentant un trimestre particulier)" permet de définir un trimestre particulier (ex 202501 pour le 1er trimestre 2025). Par défaut, le trimestre le plus récent disponible est sélectionné.
periode_compar	string Enum: "trimestre-1" "..." "trimestre-8" "annee-1" "annee-2" si periode trimestre -> valeurs possibles de trimestre-1 à trimestre-8, annee-1, annee-2.
milieu	string Enum: "rural" "intermediaire" "urbain" "tous" Important, cet indicateur ne peut être utilisé que si echelle_geo sélectionnée est departement.

Responses

Response samples

Content type

application/json

{"status": 200,
"search": {"type_bien": "tous",
"type_vendeur": "tous",
"echelle_geo": "departement",
"secteur_geo": "29",
"periode": "trimestre"
},
"main_key": "baisse_prix_annonces",
"unit": [{"value": "percentage",
"variation": "points"
}
],
"data": [{"category": "trimestre_2024-04",
"values": [{"category": "bien_appartement",
"values": [{"category": "vendeur_particulier",
"values": [{"key": "nb_annonces",
"value": 29
},
{"key": "baisse_prix",
"value": -3.85,
"min": -6.32,
"max": -2.91,
"variation": -0.5
}
]
},
{"category": "vendeur_professionnel",
"values": [{"key": "nb_annonces",
"value": 72
},
{"key": "baisse_prix",
"value": -4.04,
"min": -6.16,
"max": -2.08,
"variation": 0.44
}
]
},
{"category": "vendeur_tous",
"values": [{"key": "nb_annonces",
"value": 101
},
{"key": "baisse_prix",
"value": -4,
"min": -6.25,
"max": -2.38,
"variation": 0.47
}
]
}
]
},
{"category": "bien_maison",
"values": [{"category": "vendeur_particulier",
"values": [{"key": "nb_annonces",
"value": 63
},
{"key": "baisse_prix",
"value": -4.31,
"min": -6.67,
"max": -2.84,
"variation": 1.05
}
]
},
{"category": "vendeur_professionnel",
"values": [{"key": "nb_annonces",
"value": 228
},
{"key": "baisse_prix",
"value": -4.81,
"min": -7.14,
"max": -2.63,
"variation": 0
}
]
},
{"category": "vendeur_tous",
"values": [{"key": "nb_annonces",
"value": 291
},
{"key": "baisse_prix",
"value": -4.72,
"min": -6.98,
"max": -2.8,
"variation": 0.2
}
]
}
]
},
{"category": "bien_tous",
"values": [{"category": "vendeur_particulier",
"values": [{"key": "nb_annonces",
"value": 92
},
{"key": "baisse_prix",
"value": -4.28,
"min": -6.67,
"max": -2.85,
"variation": 1
}
]
},
{"category": "vendeur_professionnel",
"values": [{"key": "nb_annonces",
"value": 300
},
{"key": "baisse_prix",
"value": -4.64,
"min": -6.74,
"max": -2.54,
"variation": 0.12
}
]
},
{"category": "vendeur_tous",
"values": [{"key": "nb_annonces",
"value": 392
},
{"key": "baisse_prix",
"value": -4.51,
"min": -6.71,
"max": -2.62,
"variation": 0.27
}
]
}
]
}
]
}
]
}

Retourne le taux de transformation des annonces en compromis.

Authorizations:

ApiKeyAuth

query Parameters

type_bien	string Enum: "appartement" "maison" "tous" par défaut si valeur nulle appartement et maison
type_mandat	string Enum: "simple" "exclusif" "tous"
echelle_geo	string Enum: "france" "region" "departement" "ville" par défaut france
secteur_geo	string si echelle_geo france -> vide, region -> code region, departement -> code departement, ville -> code insee
periode	string Value: "trimestre" par défaut trimestre
timelapse	string Value: "6 chiffres représentant un trimestre particulier)" permet de définir un trimestre particulier (ex 202301 pour le 1er trimestre 2023). Par défaut, le trimestre le plus récent disponible est sélectionné.
periode_compar	string Enum: "trimestre-1" "..." "trimestre-8" "annee-1" "annee-2" si periode trimestre -> valeurs possibles de trimestre-1 à trimestre-8, annee-1, annee-2.
milieu	string Enum: "rural" "intermediaire" "urbain" "tous" Important, cet indicateur ne peut être utilisé que si echelle_geo sélectionnée est departement.

Responses

Response samples

Content type

application/json

{"status": 200,
"search": {"type_bien": "tous",
"echelle_geo": "ville",
"secteur_geo": "29019",
"periode": "trimestre",
"type_mandat": "tous"
},
"main_key": "taux_transfo_annonces",
"unit": [{"value": "percentage",
"variation": "points"
}
],
"data": [{"category": "trimestre_2024-04",
"values": [{"category": "bien_appartement",
"values": [{"category": "mandat_exclusif",
"values": [{"key": "nb_agences",
"value": 17
},
{"key": "nb_annonces",
"value": 21
},
{"key": "tx_transfo",
"value": 47.73,
"variation": -8.08
}
]
},
{"category": "mandat_simple",
"values": [{"key": "nb_agences",
"value": 14
},
{"key": "nb_annonces",
"value": 13
},
{"key": "tx_transfo",
"value": 34.21,
"variation": 0
}
]
},
{"category": "mandat_tous",
"values": [{"key": "nb_agences",
"value": 23
},
{"key": "nb_annonces",
"value": 38
},
{"key": "tx_transfo",
"value": 42.22,
"variation": 1.17
}
]
}
]
},
{"category": "bien_maison",
"values": [{"category": "mandat_exclusif",
"values": [{"key": "nb_agences",
"value": 5
},
{"key": "nb_annonces",
"value": 1
},
{"key": "tx_transfo",
"value": 16.67,
"variation": -43.33
}
]
},
{"category": "mandat_simple",
"values": [{"key": "nb_agences",
"value": 13
},
{"key": "nb_annonces",
"value": 5
},
{"key": "tx_transfo",
"value": 23.81,
"variation": 9.52
}
]
},
{"category": "mandat_tous",
"values": [{"key": "nb_agences",
"value": 17
},
{"key": "nb_annonces",
"value": 10
},
{"key": "tx_transfo",
"value": 27.78,
"variation": -5.55
}
]
}
]
},
{"category": "bien_tous",
"values": [{"category": "mandat_exclusif",
"values": [{"key": "nb_agences",
"value": 20
},
{"key": "nb_annonces",
"value": 22
},
{"key": "tx_transfo",
"value": 44,
"variation": -12.9
}
]
},
{"category": "mandat_simple",
"values": [{"key": "nb_agences",
"value": 16
},
{"key": "nb_annonces",
"value": 18
},
{"key": "tx_transfo",
"value": 30.51,
"variation": 1.66
}
]
},
{"category": "mandat_tous",
"values": [{"key": "nb_agences",
"value": 28
},
{"key": "nb_annonces",
"value": 48
},
{"key": "tx_transfo",
"value": 38.1,
"variation": -0.83
}
]
}
]
}
]
}
]
}

Carto-Retourne le prix/loyer m2 et leurs variations des biens selon le type de transaction.

Carto-Retourne le prix/loyer m2 et leurs variations des biens selon le type de transaction (vente ou location) pour la liste qui compose l'échelle géographique sélectionnée. Par exemple, l'échelle région retourne la liste des indicateurs par départements de cette région.

Authorizations:

ApiKeyAuth

path Parameters

type_transaction

required

string

Enum: "vente" "location"

query Parameters

type_bien	string Enum: "appartement" "maison" par défaut si valeur nulle appartement et maison
echelle_geo	string Enum: "france" "region" "departement" par défaut france
secteur_geo	string si echelle_geo france -> vide (retourne la liste des régions), region -> code region (retourne la liste des départements), departement -> code departement (retourne la liste des villes)
periode	string Value: "trimestre" par défaut trimestre
timelapse	string Value: "6 chiffres représentant un trimestre particulier)" permet de définir un trimestre particulier (ex 202501 pour le 1er trimestre 2025). Par défaut, le trimestre le plus récent disponible est sélectionné.

Responses

Response samples

Content type

application/json

{"status": 200,
"search": {"type_bien": "appartement et maison",
"type_transaction": "vente",
"echelle_geo": "region",
"secteur_geo": "53",
"periode": "trimestre"
},
"main_key": "prix_m2",
"unit": [{"value": "currency_surface",
"variation": "percentage"
}
],
"data": [{"category": "22",
"values": [{"key": "prix_m2",
"value": 2233,
"variation": 0.63
}
]
},
{"category": "29",
"values": [{"key": "prix_m2",
"value": 2513,
"variation": 3.37
}
]
},
{"category": "35",
"values": [{"key": "prix_m2",
"value": 3135,
"variation": -1.01
}
]
},
{"category": "56",
"values": [{"key": "prix_m2",
"value": 3044,
"variation": 2.84
}
]
}
]
}

Carto-Retourne le nombre de mandats de vente et leurs variations.

Authorizations:

ApiKeyAuth

query Parameters

type_bien	string Enum: "appartement" "maison" par défaut si valeur nulle appartement et maison
echelle_geo	string Enum: "france" "region" "departement" par défaut france
secteur_geo	string si echelle_geo france -> vide (retourne la liste des régions), region -> code region (retourne la liste des départements), departement -> code departement (retourne la liste des villes)
periode	string Enum: "trimestre" "mois" par défaut trimestre
timelapse	string Value: "6 chiffres représentant un trimestre ou un mois particulier)" permet de définir un trimestre particulier (ex 202501 pour le 1er trimestre 2025). Par défaut, le trimestre ou le mois le plus récent disponible est sélectionné.

Responses

Response samples

Content type

application/json

{"status": 200,
"search": {"type_bien": "appartement et maison",
"echelle_geo": "region",
"secteur_geo": "53",
"periode": "trimestre"
},
"main_key": "nb_mandats",
"unit": [{"value": "number",
"variation": "percentage"
}
],
"data": [{"category": "22",
"values": [{"key": "nb_mandats",
"value": 723,
"variation": -13.83
}
]
},
{"category": "29",
"values": [{"key": "nb_mandats",
"value": 1529,
"variation": -18.45
}
]
},
{"category": "35",
"values": [{"key": "nb_mandats",
"value": 2335,
"variation": -15.61
}
]
},
{"category": "56",
"values": [{"key": "nb_mandats",
"value": 1088,
"variation": -18.2
}
]
}
]
}

Carto-Retourne le prix/loyer m2 et leurs variations des demandeurs selon le type de bien et le type de transaction.

Authorizations:

ApiKeyAuth

path Parameters

type_transaction

required

string

Enum: "vente" "location"

query Parameters

type_bien	string Enum: "appartement" "maison" par défaut si valeur nulle appartement et maison
echelle_geo	string Enum: "france" "region" "departement" par défaut france
secteur_geo	string si echelle_geo france -> vide (retourne la liste des régions), region -> code region (retourne la liste des départements), departement -> code departement (retourne la liste des villes)
periode	string Value: "trimestre" par défaut trimestre
timelapse	string Value: "6 chiffres représentant un trimestre particulier)" permet de définir un trimestre particulier (ex 202501 pour le 1er trimestre 2025). Par défaut, le trimestre le plus récent disponible est sélectionné.

Responses

Response samples

Content type

application/json

{"status": 200,
"search": {"type_bien": "appartement et maison",
"type_transaction": "vente",
"echelle_geo": "region",
"secteur_geo": "53",
"periode": "trimestre"
},
"main_key": "prix_m2",
"unit": [{"value": "currency_surface",
"variation": "percentage"
}
],
"data": [{"category": "22",
"values": [{"key": "prix_m2",
"value": 3118,
"variation": 9.14
}
]
},
{"category": "29",
"values": [{"key": "prix_m2",
"value": 3000,
"variation": -5.48
}
]
},
{"category": "35",
"values": [{"key": "prix_m2",
"value": 3909,
"variation": 7.51
}
]
},
{"category": "56",
"values": [{"key": "prix_m2",
"value": 2843,
"variation": 6.6
}
]
}
]
}

Carto-Retourne le nombre de recherches et leurs variations selon le type de bien et le type de transaction.

Authorizations:

ApiKeyAuth

path Parameters

type_transaction

required

string

Enum: "vente" "location"

query Parameters

type_bien	string Enum: "appartement" "maison" par défaut si valeur nulle appartement et maison
echelle_geo	string Enum: "france" "region" "departement" par défaut france
secteur_geo	string si echelle_geo france -> vide (retourne la liste des régions), region -> code region (retourne la liste des départements), departement -> code departement (retourne la liste des villes)
periode	string Value: "trimestre" par défaut trimestre
timelapse	string Value: "6 chiffres représentant un trimestre particulier)" permet de définir un trimestre particulier (ex 202501 pour le 1er trimestre 2025). Par défaut, le trimestre le plus récent disponible est sélectionné.

Responses

Response samples

Content type

application/json

{"status": 200,
"search": {"type_bien": "appartement et maison",
"type_transaction": "vente",
"echelle_geo": "region",
"secteur_geo": "53",
"periode": "trimestre"
},
"main_key": "nb_recherches",
"unit": [{"value": "number",
"variation": "percentage"
}
],
"data": [{"category": "22",
"values": [{"key": "nb_recherches",
"value": 2757,
"variation": 26.76
}
]
},
{"category": "29",
"values": [{"key": "nb_recherches",
"value": 4910,
"variation": 13.87
}
]
},
{"category": "35",
"values": [{"key": "nb_recherches",
"value": 7067,
"variation": -9.26
}
]
},
{"category": "56",
"values": [{"key": "nb_recherches",
"value": 3572,
"variation": -5.4
}
]
}
]
}

Carto-Retourne l'évolution du nombre de compromis de vente et leurs variations.

Authorizations:

ApiKeyAuth

query Parameters

type_bien	string Enum: "appartement" "maison" par défaut si valeur nulle appartement et maison
echelle_geo	string Enum: "france" "region" "departement" par défaut france
secteur_geo	string si echelle_geo france -> vide (retourne la liste des régions), region -> code region (retourne la liste des départements), departement -> code departement (retourne la liste des villes)
periode	string Enum: "trimestre" "mois" par défaut trimestre
timelapse	string Value: "6 chiffres représentant un trimestre ou un mois particulier)" permet de définir un trimestre particulier (ex 202501 pour le 1er trimestre 2025). Par défaut, le trimestre ou le mois le plus récent disponible est sélectionné.

Responses

Response samples

Content type

application/json

{"status": 200,
"search": {"type_bien": "appartement et maison",
"echelle_geo": "region",
"secteur_geo": "53",
"periode": "trimestre"
},
"main_key": "variation_nb_compromis",
"unit": [{"value": "percentage",
"variation": "points"
}
],
"data": [{"category": "22",
"values": [{"key": "variation_nb_compromis",
"value": -5.28,
"variation": -9.44
}
]
},
{"category": "29",
"values": [{"key": "variation_nb_compromis",
"value": -1.2,
"variation": -2.2
}
]
},
{"category": "35",
"values": [{"key": "variation_nb_compromis",
"value": -0.25,
"variation": -2.86
}
]
},
{"category": "56",
"values": [{"key": "variation_nb_compromis",
"value": -7.83,
"variation": -8.2
}
]
}
]
}

Carto-Retourne l'évolution du nombre de baux de location et ses variations.

Authorizations:

ApiKeyAuth

query Parameters

type_bien	string Enum: "appartement" "maison" par défaut si valeur nulle appartement et maison
echelle_geo	string Enum: "france" "region" "departement" par défaut france
secteur_geo	string si echelle_geo france -> vide (retourne la liste des régions), region -> code region (retourne la liste des départements), departement -> code departement (retourne la liste des villes)
periode	string Enum: "trimestre" "mois" par défaut trimestre
timelapse	string Value: "6 chiffres représentant un trimestre ou un mois particulier)" permet de définir un trimestre particulier (ex 202501 pour le 1er trimestre 2025). Par défaut, le trimestre ou le mois le plus récent disponible est sélectionné.

Responses

Response samples

Content type

application/json

{"status": 200,
"search": {"type_bien": "appartement et maison",
"echelle_geo": "region",
"secteur_geo": "53",
"periode": "trimestre"
},
"main_key": "variation_nb_baux",
"unit": [{"value": "percentage",
"variation": "points"
}
],
"data": [{"category": "22",
"values": [{"key": "variation_nb_baux",
"value": 5.36,
"variation": 14.43
}
]
},
{"category": "29",
"values": [{"key": "variation_nb_baux",
"value": 15.35,
"variation": 27.27
}
]
},
{"category": "35",
"values": [{"key": "variation_nb_baux",
"value": 27.2,
"variation": 40.9
}
]
},
{"category": "56",
"values": [{"key": "variation_nb_baux",
"value": 168.56,
"variation": 12.75
}
]
}
]
}

Carto-Retourne le nombre de jours de délai de vente et ses variations.

Authorizations:

ApiKeyAuth

query Parameters

type_bien	string Enum: "appartement" "maison" par défaut si valeur nulle appartement et maison
echelle_geo	string Enum: "france" "region" "departement" par défaut france
secteur_geo	string si echelle_geo france -> vide (retourne la liste des régions), region -> code region (retourne la liste des départements), departement -> code departement (retourne la liste des villes)
periode	string Enum: "trimestre" "mois" par défaut trimestre
timelapse	string Value: "6 chiffres représentant un trimestre ou un mois particulier)" permet de définir un trimestre particulier (ex 202501 pour le 1er trimestre 2025). Par défaut, le trimestre ou le mois le plus récent disponible est sélectionné.

Responses

Response samples

Content type

application/json

{"status": 200,
"search": {"type_bien": "appartement et maison",
"echelle_geo": "region",
"secteur_geo": "53",
"periode": "trimestre"
},
"main_key": "delai",
"unit": [{"value": "day",
"variation": "number"
}
],
"data": [{"category": "22",
"values": [{"key": "delai",
"value": 65,
"variation": -11
}
]
},
{"category": "29",
"values": [{"key": "delai",
"value": 90,
"variation": 20
}
]
},
{"category": "35",
"values": [{"key": "delai",
"value": 69,
"variation": 3
}
]
},
{"category": "56",
"values": [{"key": "delai",
"value": 100,
"variation": 9
}
]
}
]
}

Carto-Retourne le pourcentage de négociation entre le dernier prix et le prix de vente et ses variations.

Authorizations:

ApiKeyAuth

query Parameters

type_bien	string Enum: "appartement" "maison" par défaut si valeur nulle appartement et maison
echelle_geo	string Enum: "france" "region" "departement" par défaut france
secteur_geo	string si echelle_geo france -> vide (retourne la liste des régions), region -> code region (retourne la liste des départements), departement -> code departement (retourne la liste des villes)
periode	string Enum: "trimestre" "mois" par défaut trimestre
timelapse	string Value: "6 chiffres représentant un trimestre ou un mois particulier)" permet de définir un trimestre particulier (ex 202501 pour le 1er trimestre 2025). Par défaut, le trimestre ou le mois le plus récent disponible est sélectionné.

Responses

Response samples

Content type

application/json

{"status": 200,
"search": {"type_bien": "appartement et maison",
"echelle_geo": "region",
"secteur_geo": "53",
"periode": "trimestre"
},
"main_key": "marge_nego",
"unit": [{"value": "percentage",
"variation": "percentage"
}
],
"data": [{"category": "22",
"values": [{"key": "marge_nego",
"value": 5.13,
"variation": 0.13
}
]
},
{"category": "29",
"values": [{"key": "marge_nego",
"value": 6.1,
"variation": 1.07
}
]
},
{"category": "35",
"values": [{"key": "marge_nego",
"value": 4.88,
"variation": -0.11
}
]
},
{"category": "56",
"values": [{"key": "marge_nego",
"value": 5.26,
"variation": 0
}
]
}
]
}

Carto-Retourne la baisse de prix entre le premier prix et le prix de vente et ses variations.

Authorizations:

ApiKeyAuth

query Parameters

type_bien	string Enum: "appartement" "maison" par défaut si valeur nulle appartement et maison
echelle_geo	string Enum: "france" "region" "departement" par défaut france
secteur_geo	string si echelle_geo france -> vide (retourne la liste des régions), region -> code region (retourne la liste des départements), departement -> code departement (retourne la liste des villes)
periode	string Enum: "trimestre" "mois" par défaut trimestre
timelapse	string Value: "6 chiffres représentant un trimestre ou un mois particulier)" permet de définir un trimestre particulier (ex 202501 pour le 1er trimestre 2025). Par défaut, le trimestre ou le mois le plus récent disponible est sélectionné.

Responses

Response samples

Content type

application/json

{"status": 200,
"search": {"type_bien": "appartement et maison",
"echelle_geo": "region",
"secteur_geo": "53",
"periode": "trimestre"
},
"main_key": "baisse_prix",
"unit": [{"value": "percentage",
"variation": "percentage"
}
],
"data": [{"category": "22",
"values": [{"key": "baisse_prix",
"value": 9,
"variation": 0.21
}
]
},
{"category": "29",
"values": [{"key": "baisse_prix",
"value": 8,
"variation": 1.04
}
]
},
{"category": "35",
"values": [{"key": "baisse_prix",
"value": 7,
"variation": 0.15
}
]
},
{"category": "56",
"values": [{"key": "baisse_prix",
"value": 9,
"variation": 1.67
}
]
}
]
}

Carto-Retourne le nombre de jours entre la signature de deux baux pour une location et ses variations.

Authorizations:

ApiKeyAuth

query Parameters

type_bien	string Enum: "appartement" "maison" par défaut si valeur nulle appartement et maison
echelle_geo	string Enum: "france" "region" "departement" par défaut france
secteur_geo	string si echelle_geo france -> vide (retourne la liste des régions), region -> code region (retourne la liste des départements), departement -> code departement (retourne la liste des villes)
periode	string Enum: "trimestre" "mois" par défaut trimestre
timelapse	string Value: "6 chiffres représentant un trimestre ou un mois particulier)" permet de définir un trimestre particulier (ex 202501 pour le 1er trimestre 2025). Par défaut, le trimestre ou le mois le plus récent disponible est sélectionné.

Responses

Response samples

Content type

application/json

{"status": 200,
"search": {"type_bien": "appartement et maison",
"echelle_geo": "region",
"secteur_geo": "53",
"periode": "trimestre"
},
"main_key": "baisse_prix",
"unit": [{"value": "day",
"variation": "number"
}
],
"data": [{"category": "22",
"values": [{"key": "nb_jours_entre_baux",
"value": 525,
"variation": 314
}
]
},
{"category": "29",
"values": [{"key": "nb_jours_entre_baux",
"value": 271,
"variation": -101
}
]
},
{"category": "35",
"values": [{"key": "nb_jours_entre_baux",
"value": 378,
"variation": -388
}
]
},
{"category": "56",
"values": [{"key": "nb_jours_entre_baux",
"value": 592,
"variation": -485
}
]
}
]
}

Carto-Retourne le taux de transformation des mandats en compromis et ses variations.

Authorizations:

ApiKeyAuth

query Parameters

type_bien	string Enum: "appartement" "maison" par défaut si valeur nulle appartement et maison
echelle_geo	string Enum: "france" "region" "departement" par défaut france
secteur_geo	string si echelle_geo france -> vide (retourne la liste des régions), region -> code region (retourne la liste des départements), departement -> code departement (retourne la liste des villes)
periode	string Enum: "trimestre" "mois" par défaut trimestre
timelapse	string Value: "6 chiffres représentant un trimestre ou un mois particulier)" permet de définir un trimestre particulier (ex 202501 pour le 1er trimestre 2025). Par défaut, le trimestre ou le mois le plus récent disponible est sélectionné.

Responses

Response samples

Content type

application/json

{"status": 200,
"search": {"type_bien": "appartement et maison",
"echelle_geo": "region",
"secteur_geo": "53",
"periode": "trimestre"
},
"main_key": "tx_transfo",
"unit": [{"value": "percentage",
"variation": "percentage"
}
],
"data": [{"category": "22",
"values": [{"key": "tx_transfo",
"value": 16.33,
"variation": -6.21
}
]
},
{"category": "29",
"values": [{"key": "tx_transfo",
"value": 17.23,
"variation": 0.81
}
]
},
{"category": "35",
"values": [{"key": "tx_transfo",
"value": 20.27,
"variation": -0.81
}
]
},
{"category": "56",
"values": [{"key": "tx_transfo",
"value": 12.26,
"variation": -1.62
}
]
}
]
}

Carto-Retourne le nombre de DPE et ses variations.

Authorizations:

ApiKeyAuth

query Parameters

type_bien	string Enum: "appartement" "maison" par défaut si valeur nulle appartement et maison
echelle_geo	string Enum: "france" "region" "departement" par défaut france
secteur_geo	string si echelle_geo france -> vide (retourne la liste des régions), region -> code region (retourne la liste des départements), departement -> code departement (retourne la liste des villes)
periode	string Enum: "trimestre" "mois" par défaut trimestre
timelapse	string Value: "6 chiffres représentant un trimestre ou un mois particulier)" permet de définir un trimestre particulier (ex 202501 pour le 1er trimestre 2025). Par défaut, le trimestre ou le mois le plus récent disponible est sélectionné.

Responses

Response samples

Content type

application/json

{"status": 200,
"search": {"type_bien": "appartement et maison",
"echelle_geo": "region",
"secteur_geo": "53",
"periode": "trimestre"
},
"main_key": "nb_dpe",
"unit": [{"value": "number",
"variation": "percentage"
}
],
"data": [{"category": "22",
"values": [{"key": "nb_dpe",
"value": 1939,
"variation": 2.32
}
]
},
{"category": "29",
"values": [{"key": "nb_dpe",
"value": 3212,
"variation": 0.7
}
]
},
{"category": "35",
"values": [{"key": "nb_dpe",
"value": 3482,
"variation": -3.17
}
]
},
{"category": "56",
"values": [{"key": "nb_dpe",
"value": 2182,
"variation": 0.15
}
]
}
]
}

Carto-Retourne l'évolution du nombre d'annonces publiées (vente ou location).

Authorizations:

ApiKeyAuth

path Parameters

type_transaction

required

string

Enum: "vente" "location"

query Parameters

type_bien	string Enum: "appartement" "maison" par défaut si valeur nulle appartement et maison
echelle_geo	string Enum: "france" "region" "departement" par défaut france
secteur_geo	string si echelle_geo france -> vide (retourne la liste des régions), region -> code region (retourne la liste des départements), departement -> code departement (retourne la liste des villes)
periode	string Enum: "trimestre" "mois" par défaut trimestre
timelapse	string Value: "6 chiffres représentant un trimestre ou un mois particulier" permet de définir un trimestre ou un mois particulier (ex 202501 pour le 1er trimestre 2025). Par défaut, le trimestre ou le mois le plus récent disponible est sélectionné.

Responses

Response samples

Content type

application/json

{"status": 200,
"search": {"type_bien": "appartement et maison",
"type_transaction": "vente",
"echelle_geo": "region",
"secteur_geo": "53",
"periode": "trimestre"
},
"main_key": "variation_nb_publications",
"unit": [{"value": "percentage",
"variation": "points"
}
],
"data": [{"category": "22",
"values": [{"key": "variation_nb_publications",
"value": 2757,
"variation": 26.76
}
]
},
{"category": "29",
"values": [{"key": "variation_nb_publications",
"value": 4910,
"variation": 13.87
}
]
},
{"category": "35",
"values": [{"key": "variation_nb_publications",
"value": 7067,
"variation": -9.26
}
]
},
{"category": "56",
"values": [{"key": "variation_nb_publications",
"value": 3572,
"variation": -5.4
}
]
}
]
}

Carto-Retourne la durée médiane de diffusion d'annonces sur les portails (vente ou location).

Authorizations:

ApiKeyAuth

path Parameters

type_transaction

required

string

Enum: "vente" "location"

query Parameters

type_bien	string Enum: "appartement" "maison" par défaut si valeur nulle appartement et maison
echelle_geo	string Enum: "france" "region" "departement" par défaut france
secteur_geo	string si echelle_geo france -> vide (retourne la liste des régions), region -> code region (retourne la liste des départements), departement -> code departement (retourne la liste des villes)
periode	string Value: "trimestre" par défaut trimestre
timelapse	string Value: "6 chiffres représentant un trimestre particulier" permet de définir un trimestre particulier (ex 202501 pour le 1er trimestre 2025). Par défaut, le trimestre le plus récent disponible est sélectionné.

Responses

Response samples

Content type

application/json

{"status": 200,
"search": {"type_bien": "appartement et maison",
"type_transaction": "vente",
"echelle_geo": "region",
"secteur_geo": "53",
"periode": "trimestre"
},
"main_key": "duree_publication",
"unit": [{"value": "day",
"variation": "day"
}
],
"data": [{"category": "22",
"values": [{"key": "duree_publication",
"value": 78,
"variation": -3
}
]
},
{"category": "29",
"values": [{"key": "duree_publication",
"value": 69,
"variation": -7
}
]
},
{"category": "35",
"values": [{"key": "duree_publication",
"value": 73,
"variation": -10
}
]
},
{"category": "56",
"values": [{"key": "duree_publication",
"value": 76,
"variation": -3
}
]
}
]
}

Carto-Retourne la baisse de prix médiane enregistrée en fonction de la durée de publication des annonces de vente.

Authorizations:

ApiKeyAuth

query Parameters

type_bien	string Enum: "appartement" "maison" par défaut si valeur nulle appartement et maison
echelle_geo	string Enum: "france" "region" "departement" par défaut france
secteur_geo	string si echelle_geo france -> vide (retourne la liste des régions), region -> code region (retourne la liste des départements), departement -> code departement (retourne la liste des villes)
periode	string Value: "trimestre" par défaut trimestre
timelapse	string Value: "6 chiffres représentant un trimestre particulier" permet de définir un trimestre particulier (ex 202501 pour le 1er trimestre 2025). Par défaut, le trimestre le plus récent disponible est sélectionné.

Responses

Response samples

Content type

application/json

{"status": 200,
"search": {"type_bien": "appartement et maison",
"type_transaction": "vente",
"echelle_geo": "region",
"secteur_geo": "53",
"periode": "trimestre"
},
"main_key": "baisse_prix_annonces",
"unit": [{"value": "percentage",
"variation": "points"
}
],
"data": [{"category": "22",
"values": [{"key": "baisse_prix",
"value": -5.26,
"variation": 0.3
}
]
},
{"category": "29",
"values": [{"key": "baisse_prix",
"value": -4.51,
"variation": 0.27
}
]
},
{"category": "35",
"values": [{"key": "baisse_prix",
"value": -4.48,
"variation": 0.11
}
]
},
{"category": "56",
"values": [{"key": "baisse_prix",
"value": -5.22,
"variation": -0.44
}
]
}
]
}

Carto-Retourne le taux de transformation des annonces en compromis et ses variations.

Authorizations:

ApiKeyAuth

query Parameters

type_bien	string Enum: "appartement" "maison" par défaut si valeur nulle appartement et maison
echelle_geo	string Enum: "france" "region" "departement" par défaut france
secteur_geo	string si echelle_geo france -> vide (retourne la liste des régions), region -> code region (retourne la liste des départements), departement -> code departement (retourne la liste des villes)
periode	string Value: "trimestre" par défaut trimestre
timelapse	string Value: "6 chiffres représentant un trimestre particulier)" permet de définir un trimestre particulier (ex 202501 pour le 1er trimestre 2025). Par défaut, le trimestre le plus récent disponible est sélectionné.

Responses

Response samples

Content type

application/json

{"status": 200,
"search": {"type_bien": "appartement et maison",
"echelle_geo": "region",
"secteur_geo": "53",
"periode": "trimestre"
},
"main_key": "tx_transfo",
"unit": [{"value": "percentage",
"variation": "percentage"
}
],
"data": [{"category": "22",
"values": [{"key": "tx_transfo",
"value": 21,
"variation": -15
}
]
},
{"category": "29",
"values": [{"key": "tx_transfo",
"value": 17.23,
"variation": 0.81
}
]
},
{"category": "35",
"values": [{"key": "tx_transfo",
"value": 20.27,
"variation": -0.81
}
]
},
{"category": "56",
"values": [{"key": "tx_transfo",
"value": 12.26,
"variation": -1.62
}
]
}
]
}