Aller au contenu
Pour
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.

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.

Recevez chaque mois les nouveaux permis de votre commune

Le lendemain de chaque publication de l’État, une fois par mois, avec l’entreprise qui porte le projet quand c’en est une. Gratuit.

Un e-mail de confirmation part d’abord : rien ne vous est envoyé sans votre clic. Chaque e-mail permet d’arrêter en un clic.

Votre adresse sert seulement à cet envoi, elle n’est ni vendue ni prêtée. Vos données

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 %).

SignalPoidsCe qu’il mesure
Prix des ventes voisines16 %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 permis14 %Démolition 95, déclaration préalable logement 90, permis de construire logement 70, locaux 40 à 50, permis d’aménager 30
Zone du PLU11 %Zone urbaine 100, à urbaniser 80, agricole 20, naturelle 15
Profil du demandeur10 %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 terrain9 %100 entre 200 et 2 000 m², moins en dessous et au-dessus
Activité du département8 %100 pour les 13 départements les plus actifs, 70 pour 17 autres, 40 ailleurs
Cohérence avec les ventes voisines8 %Un permis de logement entouré de ventes de logements est cohérent
Risques8 %Inverse du niveau de risque (Géorisques) : faible 100, modéré 60, élevé 30, critique 10
Densité bâtie de la parcelle8 %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 demandeur3 %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

NoteNiveauLecture
80 à 100PremiumSignaux convergents : à étudier en priorité
60 à 79ÉlevéLa majorité des signaux sont positifs
30 à 59MoyenSignaux mitigés, à compléter par votre connaissance du secteur
0 à 29FaibleOpé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 :

SignalValeurPoidsContribution
Prix des ventes voisines (médiane 2 970 €/m²)2116 %3,36
Type de permis (logement)7014 %9,80
Zone du PLU (UA1, zone urbaine constructible)10011 %11,00
Profil du demandeur (société par actions simplifiée)6510 %6,50
Surface du terrain (765 m²)1009 %9,00
Activité du département (13)1008 %8,00
Cohérence avec les ventes voisines1008 %8,00
Risques (niveau élevé)308 %2,40
Densité bâtie de la parcelle (5 bâtiments sur 765 m²)658 %5,20
Densité de la commune (dense)805 %4,00
Fiche SIRENE (demandeur pas encore retrouvé)503 %1,50
Total69

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écessairesAucune donnée d’entraînementDes avis d’utilisateurs sur des centaines de permis
ExplicationChaque signal est lisible (/score/explain)Plus difficile à expliquer
RéglagePoids é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

  1. Les poids sont fixés à la main. Ils ne sont pas appris sur des opérations réelles.
  2. 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.
  3. Des signaux peuvent être neutres quand une donnée manque, comme dans l’exemple ci-dessus.
  4. 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.

Les nouveaux permis de votre zone, chaque mois

Un e-mail le lendemain de chaque publication de l’État. Gratuit, sans compte.

Un e-mail de confirmation part d’abord : rien ne vous est envoyé sans votre clic. Chaque e-mail permet d’arrêter en un clic.

Votre adresse sert seulement à cet envoi, elle n’est ni vendue ni prêtée. Vos données

Regardez les permis de votre secteur.

Un département au choix, les nouveaux permis des 2 derniers mois, sans carte bancaire. Une question ? Écrivez à Evan : evan@permisapi.fr

Lire la documentation

Autres tutoriels