La note d’opportunité : comment PermisAPI note chaque permis de 0 à 100
Pour qui : marchands de biens, agents immobiliers, investisseurs, banques.
Temps : 7 minutes de lecture.
Budget : formule Régional (99 € par mois) et suivantes : la note n’est pas comprise dans l’accès gratuit ni dans Explorer.
En bref : chaque permis reçoit une note de 0 à 100 qui répond à une question : « ce permis mérite-t-il qu’un marchand de biens s’y intéresse ? ». C’est une moyenne pondérée de 11 signaux observables (version v0.3), sans apprentissage automatique, calculée à l’avance pour tous les permis. Vous pouvez filtrer une recherche sur la note et demander, pour un permis, le détail des 11 signaux.
Le problème métier
Un marchand de biens voit passer des dizaines de permis par semaine sur son secteur. Pour chacun, la même question : est-ce que ça vaut le coup de creuser ? Pour y répondre à la main, il faut regarder le type d’opération, le demandeur, le prix du quartier, le zonage, les risques. La note fait ce premier tri : elle ne remplace pas l’étude d’un dossier, elle aide à choisir lesquels étudier.
Les 11 signaux et leur poids
Chaque signal donne une valeur de 0 à 100 ; la note est la somme des valeurs multipliées par leur poids (total des poids : 100 %).
| Signal | Poids | Ce qu’il mesure |
|---|---|---|
| Prix des ventes voisines | 16 % | Prix médian au m² des 5 ventes DVF les plus proches : 1 000 €/m² donne 0, 10 000 €/m² et plus donnent 100 |
| Type de permis | 14 % | Démolition 95, déclaration préalable logement 90, permis de construire logement 70, locaux 40 à 50, permis d’aménager 30 |
| Zone du PLU | 11 % | Zone urbaine 100, à urbaniser 80, agricole 20, naturelle 15 |
| Profil du demandeur | 10 % | Selon la catégorie juridique publiée par Sitadel : SCI 90, entrepreneur individuel 75, société commerciale (SARL, SAS, SA) 65, collectivité, établissement public, association ou société agricole 50, grand promoteur national 20 ; demandeur non publié 50 |
| Surface du terrain | 9 % | 100 entre 200 et 2 000 m², moins en dessous et au-dessus |
| Activité du département | 8 % | 100 pour les 13 départements les plus actifs, 70 pour 17 autres, 40 ailleurs |
| Cohérence avec les ventes voisines | 8 % | Un permis de logement entouré de ventes de logements est cohérent |
| Risques | 8 % | Inverse du niveau de risque (Géorisques) : faible 100, modéré 60, élevé 30, critique 10 |
| Densité bâtie de la parcelle | 8 % | Bâtiments existants rapportés à la surface de la parcelle : une parcelle peu bâtie a du potentiel |
| Densité de la commune (INSEE) | 5 % | Dense 80, intermédiaire 70, rurale 50 |
| Fiche SIRENE du demandeur | 3 % | Activité de l’entreprise, quand le demandeur est retrouvé au répertoire |
Quand une donnée manque (permis sans ventes voisines, zonage pas encore connu, demandeur non retrouvé), le signal vaut une valeur neutre, le plus souvent 50 : la note reste calculable.
Les quatre niveaux
| Note | Niveau | Lecture |
|---|---|---|
| 80 à 100 | Premium | Signaux convergents : à étudier en priorité |
| 60 à 79 | Élevé | La majorité des signaux sont positifs |
| 30 à 59 | Moyen | Signaux mitigés, à compléter par votre connaissance du secteur |
| 0 à 29 | Faible | Opération peu typique d’un marchand de biens |
Un exemple réel
Permis de construire de logements au 12-16 rue du Capitaine Galinat, Marseille 5e
(0130552500467), demandé par une société, sur un terrain de 765 m². Le 1er novembre 2026 :
curl -H "X-API-Key: pk_live_..." \
https://api.permisapi.fr/v1/permits/0130552500467/score
{
"num_pa": "0130552500467",
"permit_id": 3303583,
"score": 69,
"tier": "high",
"components": {
"type": 70, "surface": 100, "dvf_value": 21, "dep_activity": 100,
"demandeur": 65, "dvf_coherence": 100, "density": 80, "plu": 100,
"risk": 30, "sirene": 50, "building_density": 65
},
"weights": {
"type": 0.14, "surface": 0.09, "dvf_value": 0.16, "dep_activity": 0.08,
"demandeur": 0.1, "dvf_coherence": 0.08, "density": 0.05, "plu": 0.11,
"risk": 0.08, "sirene": 0.03, "building_density": 0.08
},
"version": "v0.3",
"method": "heuristique pondérée (11 signaux v0.3)",
"dvf_matches_used": 5,
"dvf_median_price_per_m2": 2969.7,
"dvf_median_sample_size": 5,
"dvf_median_basis": "Médiane de 5 ventes (surface bâtie de 10 à 1 000 m²) parmi 5 ventes voisines retenues (au moins 1 000 €, une par mutation) ; même valeur partout, quel que soit le nombre de ventes affichées.",
"density_class": 1
}
La note vaut 69 : niveau élevé. La réponse donne la note de chacun des 11 signaux
(components) et son poids (weights) ; GET /v1/permits/0130552500467/score/explain
(2 requêtes décomptées) y ajoute une explication en français pour chaque signal :
| Signal | Valeur | Poids | Contribution |
|---|---|---|---|
| Prix des ventes voisines (médiane 2 970 €/m²) | 21 | 16 % | 3,36 |
| Type de permis (logement) | 70 | 14 % | 9,80 |
| Zone du PLU (UA1, zone urbaine constructible) | 100 | 11 % | 11,00 |
| Profil du demandeur (société par actions simplifiée) | 65 | 10 % | 6,50 |
| Surface du terrain (765 m²) | 100 | 9 % | 9,00 |
| Activité du département (13) | 100 | 8 % | 8,00 |
| Cohérence avec les ventes voisines | 100 | 8 % | 8,00 |
| Risques (niveau élevé) | 30 | 8 % | 2,40 |
| Densité bâtie de la parcelle (5 bâtiments sur 765 m²) | 65 | 8 % | 5,20 |
| Densité de la commune (dense) | 80 | 5 % | 4,00 |
| Fiche SIRENE (demandeur pas encore retrouvé) | 50 | 3 % | 1,50 |
| Total | 69 |
Ce qui tire la note vers le haut : une zone urbaine constructible du PLU, la surface du terrain, un département actif, des ventes voisines cohérentes (des appartements). Ce qui la tire vers le bas : un prix au m² modéré et le niveau de risque, élevé (six risques recensés pour la commune, dont trois couverts par un plan de prévention). Un signal reste neutre faute de donnée, la fiche SIRENE : la note de ce permis pourra encore bouger quand elle sera connue. Elle a déjà bougé une fois : le 9 octobre 2026, le zonage de ce permis n’était pas encore connu (signal PLU neutre, 50) et la note valait 63 ; son enregistrement, le 16 octobre, l’a portée à 69.
Filtrer une recherche sur la note
Avec une formule Régional ou suivante, /v1/permits accepte min_score :
import os
import httpx
r = httpx.get(
"https://api.permisapi.fr/v1/permits",
headers={"X-API-Key": os.environ["PERMISAPI_KEY"]},
params={"dep_code": "13", "min_score": 80, "date_from": "2026-07-01", "limit": 50},
timeout=30,
)
r.raise_for_status()
for p in r.json()["data"]:
print(p["num_pa"], p["score_mdb"], p["score_mdb_tier"], p["full_address"])
Chaque permis renvoyé compte pour une requête. Avec le SDK Python
(pip install permisapi-client), la note d’un permis s’obtient avec
client.permits.score_mdb("0130552500467").
Pourquoi une moyenne pondérée et pas un modèle d’apprentissage
| Moyenne pondérée (aujourd’hui) | Modèle appris (plus tard, peut-être) | |
|---|---|---|
| Données nécessaires | Aucune donnée d’entraînement | Des avis d’utilisateurs sur des centaines de permis |
| Explication | Chaque signal est lisible (/score/explain) | Plus difficile à expliquer |
| Réglage | Poids écrits dans le code, versionnés (v0.3) | Réentraînement et suivi |
Pour préparer la suite, vous pouvez donner votre avis sur la note d’un permis avec
POST /v1/score/feedback.
Limites connues
- Les poids sont fixés à la main. Ils ne sont pas appris sur des opérations réelles.
- Le demandeur est reconnu par mots-clés (« SCI », noms de grands promoteurs) : une SCI dont le nom ne contient pas « SCI » est notée comme un particulier.
- Des signaux peuvent être neutres quand une donnée manque, comme dans l’exemple ci-dessus.
- La note n’est pas un avis d’investissement : c’est un outil de tri.
Suite
Vous trouvez une note manifestement fausse sur un permis ? Envoyez le numéro du permis et
votre avis à evan@permisapi.fr, ou par POST /v1/score/feedback. La note est comprise dans la
formule Régional (99 € par mois, 5 départements) et dans les suivantes.