Documentation API
v141 simulateurs immobiliers accessibles via REST API. Rentabilite, fiscalite, financement, transmission. Commencez avec 1 000 appels/mois gratuits, sans carte bancaire.
Demarrage rapide
Premier appel en 30 secondes. Creez un compte, generez une cle, appelez.
# 1. Créez un compte sur cadaimmo.com/connexion
# 2. Générez une clé sur cadaimmo.com/api-keys
# 3. Appelez un outil :
curl -X POST https://www.cadaimmo.com/api/v1/tools/frais-notaire \
-H "Authorization: Bearer cada_votre_cle_ici" \
-H "Content-Type: application/json" \
-d '{"prix": 200000, "type": "ancien"}'Authentification
Toutes les requetes necessitent un header Authorization.
Authorization: Bearer cada_votre_cle_iciDébit dépassé : réponse 429 immédiate, comptée par clé API. Volume mensuel épuisé : sur le palier gratuit, 429 ; sur un palier payant, l'appel passe et ses crédits sont facturés à l'unité jusqu'au plafond de dépense, que vous fixez depuis votre tableau de bord. Chaque réponse porte X-Usage-Limit, X-Usage-Remaining, X-Usage-Overage, X-Usage-Max et X-Api-Tier ; un 429 ajoute X-Usage-Period-Reset et Retry-After.
Ce que consomme chaque appel
Le volume inclus se compte en crédits, pas en appels. Un calcul est une fonction pure de quelques milli-secondes ; une estimation mobilise le modèle de valorisation, ses comparables et son recalage. Chaque réponse porte X-Usage-Poids, le nombre de crédits que l'appel vient de consommer.
| Appel | Chemin | Crédits |
|---|---|---|
| Calcul (les 41 simulateurs) | POST /api/v1/tools/<outil> | 1 |
| Parcelle cadastrale et ses propriétaires | GET /api/v1/donnees/parcelle | 1 |
| Zonage d'urbanisme et parcellaire | GET /api/v1/donnees/zonage | 1 |
| Permis de construire d'une commune | GET /api/v1/donnees/permis | 1 |
| Diagnostic de performance énergétique | GET /api/v1/donnees/dpe | 1 |
| Mutations DVF d'une commune | GET /api/v1/donnees/mutations | 3 |
| Propriétaires personnes morales | GET /api/v1/donnees/proprietaires | 3 |
| Occupants SIRENE d'une parcelle | POST /api/v1/donnees/occupants | 3 |
| Cessions de fonds de commerce (BODACC) | GET /api/v1/donnees/fonds-de-commerce | 1 |
| Copropriétés immatriculées (RNIC) | GET /api/v1/donnees/coproprietes | 3 |
| Estimation de valeur d'un bien | POST /api/v1/donnees/estimation | 40 |
| Estimation d'un lot (par bien) | POST /api/v1/donnees/estimation-lot | 40 |
| Loyer de marché d'une commune | GET /api/v1/donnees/loyer | 40 |
L'estimation par lot consomme 40 crédits par bien du lot, dans la limite de 200 biens par appel. Les mêmes données sont servies au site sur des chemins courts ; les intégrations passent par /api/v1/donnees/*, qui seul accepte une clé API et décompte les crédits.
Prospection foncière
RESTLes terrains repérés depuis l'outil Analyse PLU sont lisibles et modifiables depuis n'importe quel logiciel métier : portefeuille, statut d'avancement, actions de suivi. Même authentification, même quota et mêmes codes d'erreur que les outils de calcul. Les propriétaires sont des données personnelles : ils ne sortent jamais de la liste, seulement d'une fiche appelée avec include=proprietaires.