Trois façons d'utiliser PermisAPI selon votre profil. Toutes partent de la même clé d'API gratuite. Choisissez celle qui vous parle ; les autres sections restent accessibles plus bas.
Explorez l'API depuis une interface graphique : sélecteurs déroulants, boutons, carte interactive avec polygones cadastre. Aucune ligne de code.
Demandez en français à votre assistant IA ; il appelle les bonnes fonctions PermisAPI pour vous. Fonctionne avec Claude Desktop, Cursor, Windsurf. Gratuit pour tous les plans.
Intégrez PermisAPI dans votre application ou pipeline de données. SDK Python officiel, ou appels HTTP REST directs (curl, fetch, requests, etc.) avec n'importe quel langage.
Vous pouvez combiner les trois chemins. Par exemple : configurer une alerte webhook depuis l'explorateur visuel, recevoir les notifications dans Make ou Zapier, et utiliser le SDK Python dans un script qui enrichit votre CRM.
Collection officielle PermisAPI prête à l'emploi : 34 requêtes organisées en 7 dossiers (Démarrage, Parcourir, Analyser, Investiguer, Entreprises, Statistiques, Automations). 3 exemples préremplis Paris / Saint-Denis / Nice avec valeurs réelles testées en prod.
Aucun compte Postman requis pour télécharger la collection. Importez le fichier .json dans n'importe quel client API : Postman, Insomnia, Bruno, Hoppscotch, etc.
Tous les endpoints avec exemples curl / Python / JavaScript prêts à copier. Pour la référence complète avec schémas et codes d'erreur, voyez Swagger UI.
Rends-toi sur la page pricing et clique Demarrer gratuitement. Tu recois immediatement ta cle au format pk_live_.... Elle est aussi copiee dans localStorage pour le dashboard.
Aucune carte requise pour le plan Free (500 req/mois).
Pour utiliser PermisAPI dans Claude Desktop, Cursor ou Windsurf en langage naturel sans coder : pip install permisapi-mcp et configure ton client MCP. Guide complet sur permisapi.fr/mcp. 18 outils, gratuit pour tous les plans, installation en 2 minutes (ou OAuth web sans installation pour Claude.ai).
Tous les endpoints exigent le header X-API-Key. Exemple minimal :
PythonSDK officiel disponible sur PyPI : pip install permisapi-client. Pagination, async, gestion typée des erreurs et alertes webhook incluses. Voir pypi.org/project/permisapi-client.
export KEY="pk_live_xxx"
curl -H "X-API-Key: $KEY" https://api.permisapi.fr/v1/meLa reponse contient ton plan, ton quota mensuel et la date de rotation de quota.
/v1/permitsPlan : Free11 filtres (département, commune, type, dates, superficie, SIREN). Pagination 200/page max.
curl -H "X-API-Key: $KEY" \
"https://api.permisapi.fr/v1/permits?dep_code=75&limit=5"{
"items": [
{
"num_pa": "PC 075 115 24 B0001",
"dep_code": "75",
"comm_code": "75115",
"adr_localite_ter": "Paris",
"permit_type": "PC_LOGEMENT",
"etat_pa": 1,
"date_reelle_autorisation": "2024-03-12",
"superficie_terrain": 420,
"geocoded": true,
"lat": 48.8417,
"lng": 2.3221
}
],
"pagination": { "page": 1, "total": 2847, "pages": 570 }
}/v1/permits/nearPlan : FreePostGIS ST_DWithin : tous les permis dans un rayon autour d'un point GPS.
curl -H "X-API-Key: $KEY" \
"https://api.permisapi.fr/v1/permits/near?lat=48.85&lng=2.35&radius_m=500"/v1/stats/commune/{code}Plan : FreeTotal, accordés/refusés/instruction, top 10 types, YoY, avg superficie.
curl -H "X-API-Key: $KEY" \
"https://api.permisapi.fr/v1/stats/commune/75115"/v1/alertsPlan : Explorer+PermisAPI POST un JSON signe HMAC a ton URL a chaque nouveau permis matchant.
curl -X POST -H "X-API-Key: $KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Paris 18e renovations",
"center_lat": 48.88, "center_lng": 2.35,
"radius_km": 3,
"permit_types": ["PC_LOGEMENT"],
"webhook_url": "https://tonapp.fr/permisapi-hook"
}' \
"https://api.permisapi.fr/v1/alerts"/v1/permits/{num_pa}/sirenePlan : Pro+Fiche INSEE officielle : raison sociale, NAF, état admin, date création. Particulier vs promoteur vs concurrent.
curl -H "X-API-Key: $KEY" \
"https://api.permisapi.fr/v1/permits/0930662500027/sirene"/v1/permits/by-cadastrePlan : Pro+Tous les permis (PC, PA, PD, DP) sur une parcelle donnée. Section + numéro INSEE.
curl -H "X-API-Key: $KEY" \
"https://api.permisapi.fr/v1/permits/by-cadastre?section=AB&numero=126"/v1/permits/{num_pa}/dvfPlan : Pro+Top 5 transactions immobilieres voisines (5 ans glissants 2021-2025). Score combine distance + temporalite + type.
curl -H "X-API-Key: $KEY" \
"https://api.permisapi.fr/v1/permits/0930662500027/dvf?limit=5"/v1/permits/{num_pa}/scorePlan : Pro+Note 0-100 + tier (low/medium/high/premium) qui predit si un permis est une opportunite Marchand de Biens. Heuristique ponderee 7 signaux.
curl -H "X-API-Key: $KEY" \
"https://api.permisapi.fr/v1/permits/0930662500027/score"/v1/permits/{num_pa}/pluPlan : Pro+Zone urbaine / a urbaniser / agricole / naturelle + verdict constructible. Source live Géoportail de l'Urbanisme via apicarto.ign.fr.
curl -H "X-API-Key: $KEY" \
"https://api.permisapi.fr/v1/permits/0930662500027/plu"{
"num_pa": "0930662500027",
"lat": 48.8566, "lng": 2.3522,
"has_plu": true,
"zonage": {
"code": "UB",
"libelle": "Zone urbaine de densite moyenne",
"type_zone": "U",
"constructible": true,
"constructible_reason": "Zone urbaine constructible (zonage U).",
"plu_revision_date": "2018-04-12",
"plu_partition": "DU_PLU_75056_001"
},
"other_zones": [],
"source": "Géoportail de l'Urbanisme via apicarto.ign.fr"
}/v1/permits/{num_pa}/risksPlan : Pro+Risques naturels (inondation, seisme, argile) + ICPE proches + score 0-100. Source live API Géorisques.
curl -H "X-API-Key: $KEY" \
"https://api.permisapi.fr/v1/permits/0930662500027/risks"{
"num_pa": "0930662500027",
"comm_code": "75116",
"risk_score": 37,
"risk_tier": "moderate",
"risks": [
{"code": "INONDATION", "label": "Inondation", "has_ppr": true, "ppr_type": "PPRi"},
{"code": "RGA", "label": "Retrait-gonflement argile", "has_ppr": false}
],
"icpe_proches": [
{"nom": "USINE X", "regime": "ICPE soumis", "distance_m": 850}
],
"source": "Géorisques (BRGM + Ministere Transition Ecologique)",
"disclaimer": "Heuristique commune-level, pas un diagnostic juridique."
}/v1/permits/exportPlan : Business+Export streaming CSV avec 15 colonnes fixes. Cap 100k lignes Business / 1M Enterprise. Filtres dep_code, permit_type, date_from/to, etat_pa, max_rows.
curl -H "X-API-Key: $KEY" \
"https://api.permisapi.fr/v1/permits/export?dep_code=75&permit_type=PC_LOGEMENT" \
-o paris_logements.csv/v1/me/preferences/dep-codesPlan : Free / ExplorerPlan Free : 1 dep, plan Explorer : 5 deps. Choix DEFINITIF (anti-rotation, force décision metier). Upgrade plan debloque un nouveau choix.
curl -X PUT -H "X-API-Key: $KEY" \
-H "Content-Type: application/json" \
-d '{"dep_codes": ["33"]}' \
"https://api.permisapi.fr/v1/me/preferences/dep-codes"Chaque webhook arrive avec le header X-PermisAPI-Signature: sha256=<hex>. Verifie-le en temps constant avec hmac.compare_digest.
# Le webhook arrive avec le header X-PermisAPI-Signature
# Format : sha256=<hex>
# Compute ton hex localement avec openssl :
echo -n "$BODY" | openssl dgst -sha256 -hmac "$WEBHOOK_SECRET"
# Compare avec le header recu (pas de string comparison : use compare-digest)| Code | Error | Raison |
|---|---|---|
| 400 | validation_error | paramètre invalide (ex: dep_code mal forme) |
| 401 | unauthorized | header X-API-Key manquant ou clé inconnue |
| 403 | forbidden | compte désactivé (contact support) |
| 429 | rate_limit_exceeded | quota minute ou mois atteint |
| 500 | internal_error | bug cote serveur (log Sentry) |
| 503 | database_error | DB indisponible ou Stripe timeout |
| Plan | Requetes | Burst | Alertes | Prix |
|---|---|---|---|---|
| Free | 500 / mois | 10 / min | 1 alerte | 0 EUR |
| Explorer | 5 000 / mois | 60 / min | 10 alertes | 49 EUR |
| Pro | 50 000 / mois | 300 / min | 50 alertes | 199 EUR |
| Business | 500 000 / mois | 1 000 / min | 200 alertes | 499 EUR |
| Enterprise | jusqu'a 100M / mois | 20 000 / min | 10 000 alertes | a partir de 1 999 EUR |