# French Real-estate Transactions

Searches published French geolocated DVF property transactions by address area or municipality, with date, type and amount filters.

## Endpoint

- Method: `POST`
- URL: `https://api.helpmyagent.com/v1/real-estate/fr/transactions`
- Price: `0.010 USD` / call

## Machine discovery

- llms.txt: https://helpmyagent.com/llms.txt
- OpenAPI 3.1: https://api.helpmyagent.com/openapi.json
- capabilities.json: https://helpmyagent.com/capabilities.json
- MCP: https://helpmyagent.com/mcp
- RFC 9727: https://helpmyagent.com/.well-known/api-catalog
- pricing.json: https://helpmyagent.com/pricing.json
- x402: https://helpmyagent.com/.well-known/x402
- x402-service.json: https://helpmyagent.com/.well-known/x402-service.json
- Health status: https://helpmyagent.com/health

## x402 payment methods

- USDC on `eip155:8453`
- RLUSD on `xrpl:0`

## Coverage

FR

## Use when

- Find actual French property sales around an address or in a municipality.

## Avoid when

- Do not use for current property listings or asking prices.

## Limitations

- Geolocated DVF reflects published transactions and can include complex mutations; HelpMyAgent only calculates price per square metre for single-house or single-apartment mutations.
- DVF does not cover Alsace, Moselle or Mayotte; requests in those areas therefore return an empty result.

## Example queries

- Find recent apartment sales around 10 rue de la Paix, Paris.

## Freshness

```json
{
    "mode": "source_dependent"
}
```

## Sources

- [DVF géolocalisées - data.gouv.fr](https://files.data.gouv.fr/geo-dvf/latest/csv/)
- [API Géoplateforme - Géocodage (BAN/IGN)](https://data.geopf.fr/geocodage/search)

## Input schema

```json
{
    "type": "object",
    "properties": {
        "address": {
            "type": "string",
            "minLength": 5,
            "maxLength": 250,
            "description": "Optional value for “address” as defined by this API contract. (minimum length 5; maximum length 250)."
        },
        "code_insee": {
            "type": "string",
            "pattern": "^(?:[0-9]{5}|2[ABab][0-9]{3})$",
            "description": "Optional value for “code insee” as defined by this API contract."
        },
        "property_type": {
            "type": "string",
            "enum": [
                "all",
                "house",
                "apartment"
            ],
            "default": "all",
            "description": "Optional value for “property type” as defined by this API contract. (default all; allowed values: all, house, apartment)."
        },
        "date_from": {
            "type": "string",
            "format": "date",
            "description": "Optional value for “date from” as defined by this API contract."
        },
        "date_to": {
            "type": "string",
            "format": "date",
            "description": "Optional value for “date to” as defined by this API contract."
        },
        "min_amount": {
            "type": "number",
            "minimum": 0,
            "description": "Optional value for “min amount” as defined by this API contract. (minimum 0)."
        },
        "max_amount": {
            "type": "number",
            "minimum": 0,
            "description": "Optional value for “max amount” as defined by this API contract. (minimum 0)."
        },
        "radius_m": {
            "type": "integer",
            "minimum": 100,
            "maximum": 650,
            "default": 500,
            "description": "Optional value for “radius m” as defined by this API contract. (minimum 100; maximum 650; default 500)."
        },
        "limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100,
            "default": 20,
            "description": "Maximum number of records returned by this call. (minimum 1; maximum 100; default 20)."
        }
    },
    "anyOf": [
        {
            "required": [
                "address"
            ]
        },
        {
            "required": [
                "code_insee"
            ]
        }
    ],
    "additionalProperties": false,
    "description": "Structured input parameters for the real-estate/fr/transactions API."
}
```

## Output schema

```json
{
    "type": "object",
    "properties": {
        "location": {
            "type": "object",
            "properties": {
                "code_insee": {
                    "type": [
                        "string",
                        "null"
                    ],
                    "description": "Structured value returned for “code insee” as defined by this API contract."
                },
                "address": {
                    "type": [
                        "string",
                        "null"
                    ],
                    "description": "Structured value returned for “address” as defined by this API contract."
                },
                "normalized_address": {
                    "type": [
                        "string",
                        "null"
                    ],
                    "description": "Structured value returned for “normalized address” as defined by this API contract."
                },
                "postcode": {
                    "type": [
                        "string",
                        "null"
                    ],
                    "description": "Structured value returned for “postcode” as defined by this API contract."
                },
                "city": {
                    "type": [
                        "string",
                        "null"
                    ],
                    "description": "Structured value returned for “city” as defined by this API contract."
                },
                "ban_id": {
                    "type": [
                        "string",
                        "null"
                    ],
                    "description": "Structured value returned for “ban id” as defined by this API contract."
                },
                "geocoding_score": {
                    "type": [
                        "number",
                        "integer",
                        "null"
                    ],
                    "description": "Structured value returned for “geocoding score” as defined by this API contract."
                },
                "longitude": {
                    "type": [
                        "number",
                        "integer",
                        "null"
                    ],
                    "description": "Structured value returned for “longitude” as defined by this API contract."
                },
                "latitude": {
                    "type": [
                        "number",
                        "integer",
                        "null"
                    ],
                    "description": "Structured value returned for “latitude” as defined by this API contract."
                }
            },
            "required": [
                "code_insee",
                "address",
                "normalized_address",
                "postcode",
                "city",
                "ban_id",
                "geocoding_score",
                "longitude",
                "latitude"
            ],
            "additionalProperties": false,
            "description": "Structured value returned for “location” as defined by this API contract."
        },
        "coverage_scope": {
            "type": "string",
            "enum": [
                "radius",
                "commune"
            ],
            "description": "Structured value returned for “coverage scope” as defined by this API contract. (allowed values: radius, commune)."
        },
        "radius_m": {
            "type": [
                "integer",
                "null"
            ],
            "description": "Structured value returned for “radius m” as defined by this API contract."
        },
        "property_type": {
            "type": "string",
            "description": "Structured value returned for “property type” as defined by this API contract."
        },
        "source_status": {
            "type": "string",
            "enum": [
                "ok"
            ],
            "description": "Availability status of the relevant upstream public source. (allowed values: ok)."
        },
        "source_total_count": {
            "type": [
                "integer",
                "null"
            ],
            "description": "Structured value returned for “source total count” as defined by this API contract."
        },
        "returned_count": {
            "type": [
                "integer",
                "null"
            ],
            "description": "Number of records included in this response."
        },
        "truncated": {
            "type": [
                "boolean",
                "null"
            ],
            "description": "Whether additional matching records existed beyond the returned result limit."
        },
        "transactions": {
            "type": "array",
            "items": {
                "type": "object",
                "properties": {
                    "transaction_id": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Structured value returned for “transaction id” as defined by this API contract."
                    },
                    "date": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Structured value returned for “date” as defined by this API contract."
                    },
                    "nature": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Structured value returned for “nature” as defined by this API contract."
                    },
                    "amount": {
                        "type": [
                            "number",
                            "integer",
                            "null"
                        ],
                        "description": "Structured value returned for “amount” as defined by this API contract."
                    },
                    "property_type_code": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Structured value returned for “property type code” as defined by this API contract."
                    },
                    "property_type": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Structured value returned for “property type” as defined by this API contract."
                    },
                    "built_area_m2": {
                        "type": [
                            "number",
                            "integer",
                            "null"
                        ],
                        "description": "Structured value returned for “built area m2” as defined by this API contract."
                    },
                    "land_area_m2": {
                        "type": [
                            "number",
                            "integer",
                            "null"
                        ],
                        "description": "Structured value returned for “land area m2” as defined by this API contract."
                    },
                    "price_per_m2": {
                        "type": [
                            "number",
                            "integer",
                            "null"
                        ],
                        "description": "Structured value returned for “price per m2” as defined by this API contract."
                    },
                    "commune_codes": {
                        "type": "array",
                        "items": {
                            "type": "string"
                        },
                        "description": "Structured value returned for “commune codes” as defined by this API contract."
                    },
                    "parcel_ids": {
                        "type": "array",
                        "items": {
                            "type": "string"
                        },
                        "description": "Structured value returned for “parcel ids” as defined by this API contract."
                    },
                    "longitude": {
                        "type": [
                            "number",
                            "integer",
                            "null"
                        ],
                        "description": "Structured value returned for “longitude” as defined by this API contract."
                    },
                    "latitude": {
                        "type": [
                            "number",
                            "integer",
                            "null"
                        ],
                        "description": "Structured value returned for “latitude” as defined by this API contract."
                    }
                },
                "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
            },
            "description": "Structured value returned for “transactions” as defined by this API contract."
        },
        "generated_at": {
            "type": "string",
            "description": "UTC timestamp at which this derived result was generated."
        },
        "limitations": {
            "type": "array",
            "items": {
                "type": "string"
            },
            "description": "Known interpretation, source-coverage or freshness limitations for this result."
        }
    },
    "required": [
        "location",
        "coverage_scope",
        "radius_m",
        "property_type",
        "source_status",
        "source_total_count",
        "returned_count",
        "truncated",
        "transactions",
        "generated_at"
    ],
    "additionalProperties": false,
    "description": "Structured result returned by the real-estate/fr/transactions API."
}
```

## Request example

```json
{
    "address": "10 rue de la Paix 75002 Paris",
    "property_type": "apartment",
    "limit": 10
}
```

## Billing policy

```json
{
    "charge_on": "valid_result",
    "no_charge_on_empty_result": true,
    "no_charge_on_error": true
}
```