helpmyagent.com
FR Connect my AI
☰

French Property Valuation

Estimates a statistical property value range from nearby or municipal geolocated DVF comparable transactions.

0.030 USD

Charged on valid result · Empty result not charged · Errors not charged

When to use this API?

Use for

  • Estimate a French house or apartment from comparable recorded sales.

Avoid when

  • Do not present the result as a certified appraisal or guaranteed sale price.

Limitations

  • Valuation depends on the density of single-dwelling geolocated DVF comparables; VEFA/new and professional-use mutations are excluded, and built area may differ from Carrez area.
  • DVF does not cover Alsace, Moselle or Mayotte; requests in those areas therefore return an empty result.

Sources and provenance

DVF géolocalisées - data.gouv.fr

files.data.gouv.fr

API Géoplateforme - Géocodage (BAN/IGN)

data.geopf.fr

Input / Output schemas

Simplified endpoint contracts. The complete schema remains available in OpenAPI 3.1.

OpenAPI 3.1 →

Input schema
addressstring

code_inseestring

property_typestring

Required

surface_m2number

Required

radius_minteger

lookback_yearsinteger

View full JSON Schema
{
    "type": "object",
    "properties": {
        "address": {
            "type": "string",
            "minLength": 5,
            "maxLength": 250
        },
        "code_insee": {
            "type": "string",
            "pattern": "^(?:[0-9]{5}|2[ABab][0-9]{3})$"
        },
        "property_type": {
            "type": "string",
            "enum": [
                "house",
                "apartment"
            ]
        },
        "surface_m2": {
            "type": "number",
            "minimum": 9,
            "maximum": 1000
        },
        "radius_m": {
            "type": "integer",
            "minimum": 100,
            "maximum": 650,
            "default": 650
        },
        "lookback_years": {
            "type": "integer",
            "minimum": 1,
            "maximum": 5,
            "default": 3
        }
    },
    "required": [
        "property_type",
        "surface_m2"
    ],
    "anyOf": [
        {
            "required": [
                "address"
            ]
        },
        {
            "required": [
                "code_insee"
            ]
        }
    ],
    "additionalProperties": false
}
Output schema
locationobject

Required

property_typestring

Required

surface_m2number

Required

radius_minteger | null

Required

lookback_yearsinteger

Required

source_statusstring

Required

source_total_countinteger | null

Required

source_truncatedboolean | null

Required

comparable_countinteger | null

Required

median_price_per_m2number | integer | null

Required

p25_price_per_m2number | integer | null

Required

p75_price_per_m2number | integer | null

Required

estimated_valuenumber | integer | null

Required

estimated_range_lownumber | integer | null

Required

estimated_range_highnumber | integer | null

Required

confidencestring

Required

comparablesarray

Required

generated_atstring

Required

limitationsarray

View full JSON Schema
{
    "type": "object",
    "properties": {
        "location": {
            "type": "object",
            "properties": {
                "code_insee": {
                    "type": [
                        "string",
                        "null"
                    ]
                },
                "address": {
                    "type": [
                        "string",
                        "null"
                    ]
                },
                "normalized_address": {
                    "type": [
                        "string",
                        "null"
                    ]
                },
                "postcode": {
                    "type": [
                        "string",
                        "null"
                    ]
                },
                "city": {
                    "type": [
                        "string",
                        "null"
                    ]
                },
                "ban_id": {
                    "type": [
                        "string",
                        "null"
                    ]
                },
                "geocoding_score": {
                    "type": [
                        "number",
                        "integer",
                        "null"
                    ]
                },
                "longitude": {
                    "type": [
                        "number",
                        "integer",
                        "null"
                    ]
                },
                "latitude": {
                    "type": [
                        "number",
                        "integer",
                        "null"
                    ]
                }
            },
            "required": [
                "code_insee",
                "address",
                "normalized_address",
                "postcode",
                "city",
                "ban_id",
                "geocoding_score",
                "longitude",
                "latitude"
            ],
            "additionalProperties": false
        },
        "property_type": {
            "type": "string"
        },
        "surface_m2": {
            "type": "number"
        },
        "radius_m": {
            "type": [
                "integer",
                "null"
            ]
        },
        "lookback_years": {
            "type": "integer"
        },
        "source_status": {
            "type": "string",
            "enum": [
                "ok"
            ]
        },
        "source_total_count": {
            "type": [
                "integer",
                "null"
            ]
        },
        "source_truncated": {
            "type": [
                "boolean",
                "null"
            ]
        },
        "comparable_count": {
            "type": [
                "integer",
                "null"
            ]
        },
        "median_price_per_m2": {
            "type": [
                "number",
                "integer",
                "null"
            ]
        },
        "p25_price_per_m2": {
            "type": [
                "number",
                "integer",
                "null"
            ]
        },
        "p75_price_per_m2": {
            "type": [
                "number",
                "integer",
                "null"
            ]
        },
        "estimated_value": {
            "type": [
                "number",
                "integer",
                "null"
            ]
        },
        "estimated_range_low": {
            "type": [
                "number",
                "integer",
                "null"
            ]
        },
        "estimated_range_high": {
            "type": [
                "number",
                "integer",
                "null"
            ]
        },
        "confidence": {
            "type": "string",
            "enum": [
                "high",
                "medium",
                "low",
                "insufficient"
            ]
        },
        "comparables": {
            "type": "array",
            "items": {
                "type": "object",
                "properties": {
                    "transaction_id": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "date": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "nature": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "amount": {
                        "type": [
                            "number",
                            "integer",
                            "null"
                        ]
                    },
                    "property_type_code": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "property_type": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "built_area_m2": {
                        "type": [
                            "number",
                            "integer",
                            "null"
                        ]
                    },
                    "land_area_m2": {
                        "type": [
                            "number",
                            "integer",
                            "null"
                        ]
                    },
                    "price_per_m2": {
                        "type": [
                            "number",
                            "integer",
                            "null"
                        ]
                    },
                    "commune_codes": {
                        "type": "array",
                        "items": {
                            "type": "string"
                        }
                    },
                    "parcel_ids": {
                        "type": "array",
                        "items": {
                            "type": "string"
                        }
                    },
                    "longitude": {
                        "type": [
                            "number",
                            "integer",
                            "null"
                        ]
                    },
                    "latitude": {
                        "type": [
                            "number",
                            "integer",
                            "null"
                        ]
                    }
                },
                "required": [
                    "transaction_id",
                    "date",
                    "nature",
                    "amount",
                    "property_type_code",
                    "property_type",
                    "built_area_m2",
                    "land_area_m2",
                    "price_per_m2",
                    "commune_codes",
                    "parcel_ids",
                    "longitude",
                    "latitude"
                ],
                "additionalProperties": false
            }
        },
        "generated_at": {
            "type": "string"
        },
        "limitations": {
            "type": "array",
            "items": {
                "type": "string"
            }
        }
    },
    "required": [
        "location",
        "property_type",
        "surface_m2",
        "radius_m",
        "lookback_years",
        "source_status",
        "source_total_count",
        "source_truncated",
        "comparable_count",
        "median_price_per_m2",
        "p25_price_per_m2",
        "p75_price_per_m2",
        "estimated_value",
        "estimated_range_low",
        "estimated_range_high",
        "confidence",
        "comparables",
        "generated_at"
    ],
    "additionalProperties": false
}

Example queries

Estimate a 55 m² apartment near this Paris address.