Bientôt disponible - T1 2026

API
NotariaPrime

Intégrez nos calculateurs notariaux directement dans vos applications. API REST rapide, sécurisée et simple d'utilisation.

Ultra rapide

Temps de réponse < 100ms

Sécurisé

HTTPS + authentification par clé

RESTful

Architecture REST standard

Documentation

OpenAPI 3.0 complète

Endpoints disponibles

L'API NotariaPrime exposera tous nos calculateurs via des endpoints REST simples et cohérents.

POST/v1/pretaxe
Calcul de prétaxe notarialeBientôt
POST/v1/plusvalue
Calcul de plus-value immobilièreBientôt
GET/v1/bareme
Récupération du barème en vigueurBientôt
GET/v1/status
Statut de l'APIBientôt

Base URL

https://api.notariaprime.fr/v1

Exemples de code

Voici comment vous pourrez utiliser l'API NotariaPrime dans vos applications

JavaScript / TypeScript
// Exemple d'utilisation - Prétaxe Notariale
fetch('https://api.notariaprime.fr/v1/pretaxe', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_API_KEY'
  },
  body: JSON.stringify({
    prixVente: 250000,
    typeActe: 'vente',
    departement: '29'
  })
})
.then(res => res.json())
.then(data => console.log(data));

// Réponse
{
  "success": true,
  "data": {
    "emolumentsHT": 2394.75,
    "emolumentsTTC": 2873.70,
    "droitsMutation": 14500.00,
    "totalFraisNotaire": 18073.70,
    "pourcentage": 7.23,
    "details": {
      "tranches": [...]
    }
  }
}
Calcul de plus-value
// Exemple d'utilisation - Plus-Value
fetch('https://api.notariaprime.fr/v1/plusvalue', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_API_KEY'
  },
  body: JSON.stringify({
    prixAcquisition: 180000,
    dateAcquisition: "2010-03-15",
    prixVente: 320000,
    dateVente: "2025-10-13",
    travaux: 35000,
    typeLogement: "secondaire"
  })
})
.then(res => res.json())
.then(data => console.log(data));

// Réponse
{
  "success": true,
  "data": {
    "plusValueBrute": 105000,
    "dureeDetention": 15.58,
    "abattementIR": 90,
    "abattementPS": 24.75,
    "impotRevenu": 1995,
    "prelevementsSociaux": 13566,
    "totalFiscalite": 15561
  }
}
cURL
# Avec curl
curl -X POST https://api.notariaprime.fr/v1/pretaxe \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "prixVente": 250000,
    "typeActe": "vente"
  }'
Python
# Avec Python
import requests

url = "https://api.notariaprime.fr/v1/pretaxe"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY"
}
data = {
    "prixVente": 250000,
    "typeActe": "vente"
}

response = requests.post(url, json=data, headers=headers)
print(response.json())

Authentification

L'API utilisera un système d'authentification par clé API simple et sécurisé.

Clé API

Chaque requête devra inclure votre clé API dans le header Authorization :

Authorization: Bearer YOUR_API_KEY

Rate Limiting

Limites généreuses pour un usage normal :

  • 100 requêtes / minute
  • 10 000 requêtes / jour

Tarification

100% Gratuit

Comme pour la plateforme web, l'API NotariaPrime sera entièrement gratuite. Pas de frais cachés, pas d'abonnement.

Open Source & Gratuit

L'API arrive bientôt !

Nous travaillons actuellement sur l'API NotariaPrime. Le lancement est prévu pour le T1 2026. Vous souhaitez être parmi les premiers utilisateurs ?