API publique de calcul

Endpoint lecture seule, même moteur que le site. Idéal pour plugins, tableurs ou agents IA qui ont besoin d'un ordre de grandeur fiable.

GET

/api/calculate?prix=250000&departement=75&type=ancien&primo=false&mobilier=0

Paramètres

Nom	Obligatoire	Description
prix	oui	Prix du bien en euros (> 0).
departement	non (défaut 75)	Code département (2 chiffres ou 3 pour DROM, ex. 974).
type	non (défaut ancien)	`ancien`, `neuf` ou `terrain`.
primo	non	`true` / `1` pour primo-accédant.
mobilier	non	Montant de mobilier déductible (plafonné à 5 % du prix côté serveur).
frais_agence	non	Si > 0, le prix est traité comme incluant des frais d'agence à charge acquéreur (montant en €).

Réponse (succès)

JSON avec input, result (total arrondi, DMTO, émoluments, etc.) et meta (version, source).

Exemple de réponse 200 (extrait)

Même requête que ci-dessus : ancien 250 000 €, Paris (75), non primo-accédant.

{
  "input": {
    "prix": 250000,
    "departement": { "code": "75", "nom": "Paris", "slug": "paris" },
    "type": "ancien",
    "primoAccedant": false,
    "mobilier": 0,
    "fraisAgence": 0
  },
  "result": {
    "total": 19524,
    "pourcentage": 7.81,
    "baseTaxable": 250000,
    "dmto": 15800,
    "tauxDMTOApplique": 6.32,
    "emoluments": 2874,
    "emolumentsFormalites": 200,
    "csi": 250,
    "debours": 400,
    "economieReforme": 0
  },
  "meta": {
    "version": "1.0",
    "source": "https://mesfraisnotaire.fr",
    "documentation": "https://mesfraisnotaire.fr/api",
    "lastUpdate": "2026-01"
  }
}

CORS

Les en-têtes CORS autorisent l'origine *en lecture pour faciliter les intégrations front et outils no-code. Merci de ne pas saturer le service : un usage raisonnable permet de garder l'endpoint gratuit pour tous.

Limitation du débit (production)

Si les variables UPSTASH_REDIS_REST_URL et UPSTASH_REDIS_REST_TOKEN sont configurées sur Vercel, un plafond d'environ 120 requêtes / minute / IP s'applique sur /api/calculate (réponse 429 avec Retry-After). Sans Upstash, aucune limite côté code (à compléter par un WAF ou une autre politique si besoin).

Intégration agents (MCP)

Pour Cursor, Windsurf ou Claude avec transport MCP HTTP, préférez le serveur MCP (/api/mcp) : mêmes calculs exposés comme outils (calculate_frais_notaire, etc.).

Aller plus loin

Documentation MCP
Méthodologie et formules
llms-full.txt (racine du site, documentation longue pour LLM)

Retour au calculateur