API Fonciris

Version 1REST, réponses JSON

Les données de Fonciris pour une adresse ou une commune, dans vos outils : risques, prix DVF, analyse complète.

Démarrage

Obtenez une clé
Souscrivez à l’offre Pro (39,99 € par mois) et créez une clé depuis votre espace.
Analysez une adresse
Envoyez une requête GET avec l’adresse en paramètre. L’API la géocode puis lance l’analyse.
Exploitez les données
Risques, prix DVF, négociation et cadre de vie, structurés en JSON.

Testez en une commande :

curl -H "Authorization: Bearer fci_live_YOUR_API_KEY" \
  "https://fonciris.fr/api/v1/score?address=18+Avenue+Pauliani,+Nice"

Authentification

Chaque requête inclut votre clé dans l’en-tête Authorization :

Authorization: Bearer fci_live_xxxxxxxxxxxxx

Ne placez jamais votre clé dans du code exécuté par le navigateur ou dans un dépôt public.
Stockez-la dans une variable d’environnement.
Révoquez immédiatement une clé compromise depuis votre espace.

Limites

Formule	Par minute	Par jour	Crédits par mois
Pro	60	1 000	100
Partenaire API	300	10 000	Sur mesure

Chaque réponse inclut les en-têtes de limite :

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 57
X-RateLimit-Reset: 1708789260

En cas de dépassement, l’API répond 429 Too Many Requests avec un en-tête Retry-After.

Points d’accès

GET	`/api/v1/analyze`	Analyse complète	1 crédit
GET	`/api/v1/commune/:code_insee`	Commune : score, risques, marché	gratuit
GET	`/api/v1/address?q=`	Même traitement que l’aperçu (1 requête par seconde)	1 crédit
POST	`/api/v1/batch`	Jusqu’à 10 adresses	1 crédit par adresse
GET	`/api/v1/score`	Score et risques principaux	0,5 crédit
GET	`/api/v1/risks`	Risques détaillés	0,5 crédit
GET	`/api/v1/prices`	Prix DVF	0,5 crédit
GET	`/api/v1/usage`	Statistiques d’utilisation	gratuit

GET/api/v1/analyze1 crédit

Analyse complète d’une adresse : score, risques, prix DVF, négociation, cadre de vie.

Paramètres

Paramètre	Type	Description
`address`obligatoire	string	Adresse complète (ex. 18 Avenue Pauliani, 06000 Nice)
`lat`	number	Latitude (facultatif, sinon géocodée via la BAN)
`lng`	number	Longitude (facultatif)
`include`	string	Sections à inclure, séparées par des virgules : score, risks, prices, lifestyle, financial, negotiation. Par défaut : toutes

Exemple

curl -X GET "https://fonciris.fr/api/v1/analyze?address=18+Avenue+Pauliani,+06000+Nice" \
  -H "Authorization: Bearer fci_live_YOUR_API_KEY"

Voir un exemple de réponse complète

{
  "status": "success",
  "data": {
    "address": {
      "formatted": "18 Avenue Pauliani, 06000 Nice",
      "latitude": 43.7102,
      "longitude": 7.262,
      "commune": {
        "code": "06088",
        "name": "Nice",
        "department": "06"
      }
    },
    "score": {
      "global": 64,
      "level": "bon",
      "breakdown": {
        "risques_naturels": 45,
        "dynamique_quartier": 72
      }
    },
    "risks": {
      "summary": {
        "critical": 1,
        "warning": 2,
        "info": 3
      },
      "flood_zone": {
        "present": true,
        "level": "Moyen"
      },
      "clay_risk": {
        "present": true,
        "exposure": "Moyen"
      },
      "seismic_zone": {
        "level": 2
      },
      "radon": {
        "zone": 1
      },
      "seveso": {
        "nearby": false,
        "count": 0
      },
      "pollution": {
        "count": 2
      },
      "catnat_count": 83,
      "insurance_surcharge_estimate": {
        "min": 480,
        "max": 960,
        "currency": "EUR",
        "per": "year"
      }
    },
    "prices": {
      "median_per_sqm": 4700,
      "median_price": 265000,
      "trend_1y": -13.2,
      "transactions_count": 47,
      "transactions_nearby": [
        {
          "date": "2025-09-15",
          "price": 265000,
          "surface": 58,
          "price_per_sqm": 4569,
          "type": "Appartement"
        }
      ]
    },
    "negotiation": {
      "score": 67,
      "level": "forte",
      "reference_price": 282000,
      "adjusted_range": {
        "low": 220000,
        "high": 245000
      },
      "factors": [
        {
          "name": "Zone inondable",
          "decote_min": 10,
          "decote_max": 15
        },
        {
          "name": "DPE F",
          "decote_min": 5,
          "decote_max": 12
        }
      ]
    },
    "insights": [
      {
        "type": "critical",
        "title": "Zone inondable : surcoût assurance estimé",
        "message": "Impact financier estimé : +480 à 960€/an d’assurance"
      }
    ],
    "generated_at": "2026-02-25T15:30:00Z",
    "report_url": "https://fonciris.fr/dashboard/biens/abc123"
  },
  "credits_used": 1,
  "credits_remaining": 87
}

GET/api/v1/score0,5 crédit

Version allégée : score global, niveau et risques principaux. Utile pour un affichage compact ou un tri.

Paramètres

Paramètre	Type	Description
`address`obligatoire	string	Adresse complète
`lat`	number	Latitude (facultatif)
`lng`	number	Longitude (facultatif)

Exemple

curl "https://fonciris.fr/api/v1/score?address=18+Avenue+Pauliani,+Nice" \
  -H "Authorization: Bearer fci_live_YOUR_API_KEY"

Réponse

{
  "status": "success",
  "data": {
    "address": "18 Avenue Pauliani, 06000 Nice",
    "score": 64,
    "level": "bon",
    "risks_count": {
      "critical": 1,
      "warning": 2
    },
    "top_risk": "Zone inondable — aléa moyen",
    "price_trend_1y": -13.2
  }
}

GET/api/v1/risks0,5 crédit

Risques naturels et technologiques détaillés : inondation, argiles, séisme, Seveso, radon, pollution, arrêtés CatNat.

Paramètre	Type	Description
`address`obligatoire	string	Adresse complète
`lat`	number	Latitude (facultatif)
`lng`	number	Longitude (facultatif)

GET/api/v1/prices0,5 crédit

Prix DVF autour de l’adresse : prix médian au m², évolution sur un an et jusqu’à 20 ventes détaillées.

Paramètre	Type	Description
`address`obligatoire	string	Adresse complète
`lat`	number	Latitude (facultatif)
`lng`	number	Longitude (facultatif)

GET/api/v1/usagegratuit

Utilisation de votre clé : crédits restants, appels du jour et du mois, historique sur 30 jours, détail par point d’accès.

Erreurs

Code	Signification	Action
400	Bad Request	Vérifiez le paramètre address
401	Unauthorized	Vérifiez votre clé dans l’en-tête Authorization
402	Payment Required	Crédits insuffisants
403	Forbidden	L’offre Pro est requise pour l’API
429	Too Many Requests	Attendez le délai indiqué par Retry-After
500	Internal Error	Réessayez avec un délai croissant entre deux tentatives
503	Service Unavailable	Service temporairement indisponible, réessayez dans quelques minutes

Format d’erreur

{
  "status": "error",
  "error": {
    "message": "Invalid API key",
    "code": 401
  }
}

Champs de la réponse /analyze

address

Paramètre	Type	Description
`formatted`	string	Adresse normalisée
`latitude`	number	Latitude WGS84
`longitude`	number	Longitude WGS84
`commune.code`	string	Code INSEE de la commune
`commune.name`	string	Nom de la commune
`commune.department`	string	Code du département

score

Paramètre	Type	Description
`global`	number	Score Fonciris sur 100
`level`	string	Niveau qualitatif
`breakdown`	object	Scores par catégorie

risks

Paramètre	Type	Description
`flood_zone.present`	boolean	Adresse en zone inondable (PPRI)
`flood_zone.level`	string	Aléa : Faible, Moyen, Fort, Très fort
`clay_risk.exposure`	string	Exposition aux argiles : Nul, Faible, Moyen, Fort
`seismic_zone.level`	number	Zone de sismicité 1 à 5 (décret 2010-1255)
`catnat_count`	number	Nombre d’arrêtés CatNat de la commune
`insurance_surcharge_estimate`	object	Surcoût d’assurance estimé (min, max, en euros par an)

prices

Paramètre	Type	Description
`median_per_sqm`	number	Prix médian au m² (DVF, DGFiP)
`trend_1y`	number	Évolution des prix sur un an, en %
`transactions_count`	number	Nombre de ventes dans la zone
`transactions_nearby`	array	Jusqu’à 20 ventes DVF détaillées

negotiation

Paramètre	Type	Description
`score`	number	Score de négociabilité de 0 à 100
`level`	string	Niveau : faible, moderee, forte, tres_forte
`reference_price`	number	Prix de référence calculé sur DVF
`adjusted_range`	object	Fourchette de prix ajustée (low, high)
`factors`	array	Facteurs de décote, avec pourcentages min et max

Intégrer Fonciris

Offre Pro : 39,99 € par mois, rapports illimités, 100 crédits API par mois.

Obtenir une clé API Comparer les formules

Adresse de base : https://fonciris.fr · Version 1 · Sources : Géorisques, DVF (DGFiP), INSEE, BAN, ADEME.