API immobilière CADA

Les 41 calculs des outils CADA et 12 endpoints de données foncières (cadastre, DVF, DPE, zonage, loyers, copropriétés), en JSON, derrière une clé d'API. Le palier gratuit ouvre 1 000 crédits par mois, sans carte bancaire.

Adresse: https://www.cadaimmo.com/api/v1
Authentification: Authorization: Bearer cada_…
Format: JSON ; en cas d'erreur, un message en français dans error
Spécification: OpenAPI 3.1 · documentation par outil

Créer une clé d'API Voir les tarifs

Déjà une clé : tableau de bord (clés, consommation, plafond de dépense).

POST /api/v1/tools/frais-notaire

curl https://www.cadaimmo.com/api/v1/tools/frais-notaire \
  -H "Authorization: Bearer $CADA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prix":300000,"type":"ancien"}'

200 · application/json

{
  "data": {
    "assiette": 300000,
    "economieAssiette": 0,
    "dmto": 18956,
    "dmtoBrut": 18956,
    "reductionPrimo": 0,
    "emolumentsHT": 2794,
    "emolumentsHTBrut": 2794,
    "remiseNotaire": 0,
    "tva": 559,
    "emolumentsTTC": 3353,
    "csi": 300,
    "debours": 1200,
    "total": 23809,
    "pourcentage": 7.94,
    "garantie": {
      "type": "aucun",
      "montantEmprunte": 300000,
      "tpf": 0,
      "csi": 0,
      "emolumentsFormalites": 0,
      "total": 0
    },
    "totalAvecGarantie": 23809
  },
  "tool": "frais-notaire"
}

Authentification

Une clé se crée depuis le tableau de bord et commence par cada_. Elle n'est affichée qu'une fois : conservez-la dans une variable d'environnement, jamais dans un code servi au navigateur. Chaque appel la porte dans l'en-tête Authorization: Bearer. Une clé exposée se révoque depuis le même écran.

En-têtes de consommation

Portés par les réponses des calculs et des données.

X-Usage-Limit: Crédits inclus dans le mois.
X-Usage-Remaining: Crédits inclus restants.
X-Usage-Max: Seuil de coupure, plafond de dépense compris (unlimited sans plafond).
X-Usage-Overage: Crédits consommés hors forfait ce mois, donc facturés.
X-Usage-Poids: Crédits décomptés par cet appel.
X-Api-Tier: Palier du compte.

Codes d'erreur

Le corps vaut { "error": "…" }, parfois complété (champ fautif, devis, date de remise à zéro).

400: JSON invalide, paramètre manquant ou hors bornes, corps de calcul au-delà de 10 Ko.
401: Clé absente, mal formée ou révoquée.
402: Publipostage : aucune carte enregistrée sur le compte, ou paiement refusé.
404: Outil, terrain, projet ou campagne introuvable, ou rattaché à un autre compte.
409: Terrain déjà suivi ; campagne déjà payée.
413: Corps trop volumineux : 64 Ko en prospection, 2 Mo en publipostage.
422: Entrée qui produit une valeur non numérique ; campagne non conforme.
429: Débit par minute atteint (en-tête Retry-After), volume du mois épuisé ou plafond de dépense atteint.

Endpoints

Tout ce que la clé permet d'appeler, sous https://www.cadaimmo.com. Les paramètres en gras sont requis. Les crédits sont ceux que la route décompte ; « Sans clé » et « Session » ne consomment rien.

Calculs

Les 41 outils de calcul du site, un endpoint par outil. Le corps est un objet JSON plat, la réponse vaut { data, tool }.

MéthodeCheminRendCrédits

POST/api/v1/tools/{outil}

Le résultat du calcul demandé (catalogue plus bas).

Crédits : 1

GET/api/v1/tools

Le catalogue : slug, nom, catégorie, nombre de paramètres de chaque outil.

Crédits : Sans clé

POST/api/v1/sandbox/{outil}

Le même calcul, sans clé : 10 requêtes par minute et par adresse IP, corps de 5 Ko au plus.

Crédits : Sans clé

POST/api/v1/compute

L'analyse complète d'un projet locatif : coût total, prêt, cashflow avant et après impôt, rendements, fiscalité année par année.

Crédits : 1

GET/api/v1/projects

Les projets enregistrés du compte.

Crédits : 0

POST/api/v1/projects

Enregistre un projet (name, data) et rend son identifiant.

Crédits : 0

GET/api/v1/projects/{id}

Un projet et son analyse recalculée.

Crédits : 0

PUT/api/v1/projects/{id}

Remplace le nom et les données du projet.

Crédits : 0

DELETE/api/v1/projects/{id}

Supprime le projet.

Crédits : 0

Données

Cadastre, ventes DVF (2014 à 2025), DPE de l'ADEME, zonage du Géoportail de l'urbanisme, permis Sitadel, carte des loyers de l'ANIL, registre des copropriétés, BODACC, SIRENE et fichier des locaux des personnes morales. Chaque réponse nomme sa provenance.

MéthodeCheminRendCrédits

GET/api/v1/donnees/parcelle

Parcelle cadastrale sous un point

latlon

Crédits : 1

POST/api/v1/donnees/occupants

Établissements SIRENE occupant une parcelle

inseegeometry

Crédits : 3

GET/api/v1/donnees/coproprietes

Copropriétés immatriculées (RNIC)

parcelleinseelimit

Crédits : 3

GET/api/v1/donnees/mutations

Mutations DVF d'une commune

code_communecode_postaltype

Crédits : 3

GET/api/v1/donnees/dpe

Diagnostic de performance énergétique

parcellelatlonaddresscommunepostal_code

Crédits : 1

GET/api/v1/donnees/permis

Permis de construire d'une commune

insee

Crédits : 1

GET/api/v1/donnees/zonage

Zonage d'urbanisme et parcellaire

latlonparcellesbbox

Crédits : 1

POST/api/v1/donnees/estimation

Estimation de valeur d'un bien

latitudelongitudecodeCommunetypeLocalsurfaceBatisurfaceTerrainnombrePieces

Crédits : 40

POST/api/v1/donnees/estimation-lot

Estimation d'un lot de biens

items

Crédits : 40 par bien du lot

GET/api/v1/donnees/loyer

Loyer de marché d'une commune

inseetypepieces

Crédits : 40

GET/api/v1/donnees/proprietaires

Propriétaires personnes morales

latlonsirennom

Crédits : 3 1 avec lat et lon

GET/api/v1/donnees/fonds-de-commerce

Cessions de fonds de commerce (BODACC)

inseesirenparcellelimit

Crédits : 1

Prospection foncière

Les terrains suivis depuis l'Analyse PLU et leurs actions, en lecture et en écriture. Les propriétaires ne sortent que sur demande (?include=proprietaires).

MéthodeCheminRendCrédits

GET/api/v1/prospection/terrains

Lister les terrains suivis

Crédits : 1

POST/api/v1/prospection/terrains

Enregistrer un terrain

Crédits : 1

GET/api/v1/prospection/terrains/{id}

Lire un terrain

Crédits : 1

PATCH/api/v1/prospection/terrains/{id}

Mettre à jour un terrain

Crédits : 1

DELETE/api/v1/prospection/terrains/{id}

Supprimer un terrain

Crédits : 1

GET/api/v1/prospection/terrains/{id}/actions

Lister les actions d'un terrain

Crédits : 1

POST/api/v1/prospection/terrains/{id}/actions

Créer une action sur un terrain

Crédits : 1

Publipostage

Composer et poster du courrier, avec les moteurs de l'outil de publipostage. La création rend un devis sans rien débiter ; seul l'appel /envoyer débite la carte enregistrée sur le compte. L'affranchissement est facturé en plus des crédits.

MéthodeCheminRendCrédits

GET/api/v1/courriers/campagnes

Les 100 dernières campagnes du compte.

Crédits : 1

POST/api/v1/courriers/campagnes

Crée une campagne (nom, corps, destinataires, 2 000 au plus) et rend son devis.

Crédits : 1

GET/api/v1/courriers/campagnes/{id}

Statut, plis, distributions, retours et réponses reçues.

Crédits : 1

POST/api/v1/courriers/campagnes/{id}/envoyer

Débite le devis et met les plis en file d'envoi. Un second appel rend 409, jamais un second débit.

Crédits : 1

Serveur MCP

Les données foncières exposées au protocole MCP (Model Context Protocol), pour un assistant conversationnel ou un agent. Lecture seule.

MéthodeCheminRendCrédits

POST/api/v1/mcp

JSON-RPC 2.0 : initialize, tools/list, tools/call, ping.

Crédits : 1 par tools/call

GET/api/v1/mcp

Nom du serveur, version du protocole, liste des outils.

Crédits : Sans clé

Spécification et compte

La spécification se lit sans clé. Les routes du compte sont celles du tableau de bord : elles s'authentifient par la session de cadaimmo.com, pas par une clé.

MéthodeCheminRendCrédits

GET/api/v1/openapi

La spécification OpenAPI 3.1 de l'API : calculs, données, prospection.

Crédits : Sans clé

GET/api/v1/keys

Les clés du compte (préfixe, date de création, dernier usage).

Crédits : Session

POST/api/v1/keys

Crée une clé. Elle n'est affichée qu'une fois.

Crédits : Session

DELETE/api/v1/keys

Révoque une clé.

Crédits : Session

GET/api/v1/usage

Palier, consommation du mois, dépassement, historique sur 30 jours.

Crédits : Session

POST/api/v1/usage/plafond

Change le plafond de dépense mensuel (capCents).

Crédits : Session

Les 41 calculs

Un endpoint par outil : POST /api/v1/tools/{slug}. Paramètres, valeurs par défaut et exemple de réponse de chacun : documentation.

Rendement & Marché5

Financement7

Stratégie8

Fiscalité9

Transmission2

Dispositifs fiscaux6

Construction & DPE4

Essayer sans clé

Le bac à sable exécute le même calcul que /api/v1/tools, sans clé et sans compte, dans la limite de 10 requêtes par minute. Chaque outil est prérempli avec l'exemple de la documentation ; modifiez le corps, puis envoyez.

Outil

POST /api/v1/sandbox/rentabilite-locative

Réponse

La réponse JSON s'affichera ici.

Serveur MCP

Pour brancher un assistant conversationnel, un éditeur de code ou un agent sur les données foncières : le serveur /api/v1/mcp suit le Model Context Protocol (transport HTTP, JSON-RPC 2.0), en lecture seule. Il s'authentifie avec la même clé ; chaque appel d'outil coûte 1 crédit.

Déclaration dans Claude Code :

claude mcp add --transport http cada-foncier \
  https://www.cadaimmo.com/api/v1/mcp \
  --header "Authorization: Bearer cada_votre_cle"

Appel direct d'un outil :

curl https://www.cadaimmo.com/api/v1/mcp \
  -H "Authorization: Bearer $CADA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "get_ventes_dvf",
      "arguments": { "insee": "31555" }
    }
  }'

get_zonage: Zonage PLU de la commune (sous-zones, partition, URL du règlement écrit). Passe insee ou lat+lon.
inseelatlon
get_regles: Règles d'urbanisme d'une zone (emprise, hauteur, reculs, stationnement…) extraites et citées du règlement écrit. reglementUrl vient de get_zonage.
reglementUrlzone
get_ventes_dvf: Marché : synthèse des ventes récentes (DVF) de la commune (nombre, prix médian €/m²).
insee
get_proprietaire: Propriétaire d'une parcelle (personnes morales, fichier DGFiP). section+numero requis.
inseesectionnumeroprefixe
get_contigues: Parcelles contiguës à une parcelle (unité foncière plus grande). Passe insee + lat + lon.
inseelatlon
get_friches_vacance: Gisements de la commune : nombre de friches (Cartofriches) et taux de vacance (LOVAC).
insee

Tarifs

Un forfait mensuel inclut un volume de crédits ; au-delà, chaque crédit est facturé jusqu'au plafond de dépense que vous fixez. Détail par endpoint, exemples de facture et souscription : tarifs de l'API.

Palier	Forfait mensuel	Crédits inclus	Crédit au-delà	Débit par clé	Plafond par défaut
Free	0 €	1 000	Refusé (429)	10 req/min	Sans objet
Starter	25 € HT	10 000	0,006 € HT	60 req/min	200 € HT
Business	499 € HT	200 000	0,003 € HT	300 req/min	2 000 € HT
Enterprise	Sur devis	À partir de 1 000 000	Négocié	1 000 req/min	Contractuel

Questions fréquentes

Faut-il payer pour essayer ?

Non. Le bac à sable de cette page calcule sans clé, dans la limite de 10 requêtes par minute. Un compte gratuit donne ensuite une clé et 1 000 crédits par mois, sans carte bancaire.

Qu'est-ce qu'un crédit ?

L'unité de décompte de l'API. Un calcul coûte 1 crédit, des mutations DVF 3, une estimation de valeur 40. Le tableau des endpoints donne le coût de chacun, et chaque réponse d'une route à clé le rappelle dans l'en-tête X-Usage-Poids.

Que se passe-t-il quand le volume inclus est épuisé ?

Sur le palier gratuit, l'API répond 429 jusqu'au 1er du mois suivant. Sur Starter et Business, toutes les routes à clé continuent : chaque crédit au-delà est facturé 0,006 € HT sur Starter et 0,003 € HT sur Business, jusqu'au plafond de dépense du compte — 200 € et 2 000 € HT par mois par défaut, modifiables depuis le tableau de bord. Le plafond atteint, l'API répond 429.

Quelles sont les limites de débit ?

Toutes les routes à clé (calculs, données, prospection, publipostage, projets, serveur MCP) : par clé et par minute, 10 requêtes sur le palier gratuit, 60 sur Starter, 300 sur Business et 1 000 sur Enterprise. Le bac à sable, sans clé, accepte 10 requêtes par minute et par adresse IP. Au-delà, l'API répond 429 avec l'en-tête Retry-After.

Les paramètres envoyés sont-ils conservés ?

Ceux d'un calcul, non : le journal d'usage garde l'outil appelé, le statut et la durée, rien du corps de la requête. Les terrains, actions, projets et campagnes créés par l'API sont enregistrés dans votre compte, comme depuis l'interface.

Les barèmes sont-ils à jour ?

Chaque endpoint de calcul exécute la fonction de l'outil du même nom sur cadaimmo.com. Quand un barème change (loi de finances, IRL, PTZ), l'API change avec le site, sans modification de votre côté.

Existe-t-il une bibliothèque cliente ?

La spécification OpenAPI 3.1, servie sans clé sous /api/v1/openapi, décrit les calculs, les données et la prospection, paramètres et réponses compris. Les générateurs usuels (openapi-generator, openapi-typescript) en tirent un client typé dans votre langage.

Une question d'intégration : api@cadaimmo.com. Au-delà de 200 000 crédits par mois ou pour un engagement contractuel : offre Enterprise.