Find Property Comparables
find_property_comparablesFind comparable properties for valuation - the #1 tool for real estate agents.
REQUIRED parameters:
latitude, longitude: Target property coordinates
type_local: "Maison" or "Appartement"
surface_min, surface_max: Surface range in m² (typically ±20% of target)
Optional:
pieces: Number of rooms (±1 tolerance applied)
code_postal, commune: Optional administrative fallback when GPS comparables are sparse
radius_m: Search radius (default: 500m, max: 2000m)
max_age_months: Transaction age limit (default: 18, same as estimate_property_value; max: 36) When fewer than 3 comps match, the search first extends to 36 months at the same radius, then to 2 km.
limit: Max comparables (default: 10, max: 20)
Returns:
Comparable properties with similarity scores (0-1)
Distance from target, age of transaction
Adjustment suggestions, to apply to the comparable's €/m² (e.g., "+2% for 10m² larger": smaller units sell dearer per m²)
excluded_comparables: sales left out (Carrez/built surface mismatch, €/m² over 2× from the median)
Valuation estimate with comparable-agreement confidence, plus a data-calibrated 50% interval (interval.*) and traceable confidence_factors — see estimate_property_value's description for the full field reference
Example: Find comps for a 75m² apartment near Tour Eiffel: {latitude: 48.858, longitude: 2.294, type_local: "Appartement", surface_min: 60, surface_max: 90}
Cost: 10 credits per call
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum comparables to return (default: 10, max: 20) | |
| pieces | No | Number of rooms (optional, ±1 tolerance used) | |
| commune | No | Commune fallback when GPS comparables are sparse | |
| latitude | Yes | Latitude of the target property (required) | |
| radius_m | No | Search radius in meters (default: 500, max: 2000) | |
| longitude | Yes | Longitude of the target property (required) | |
| type_local | Yes | Property type (required for matching) | |
| code_postal | No | Postal code fallback when GPS comparables are sparse | |
| surface_max | Yes | Maximum surface in m² (typically target surface + 20%) | |
| surface_min | Yes | Minimum surface in m² (typically target surface - 20%) | |
| max_age_months | No | Maximum transaction age in months (default: 18, max: 36) | |
| exclude_bulk_sales | No | Exclude bulk sales (default: true) |