API

Dernière mise à jour : 30 avril 2026

L’API Foncik expose les quatre endpoints qui alimentent l’extension navigateur et le site. Format JSON, accès libre en bêta jusqu’au lancement public en mai 2026.

État de l’API : bêta publique. Endpoint stable : https://api.foncik.fr. Quota par défaut : 60 requêtes/minute par IP, sans clé. Pour des volumes supérieurs, demander une clé à bonjour@foncik.fr.

1. Score d’une annonce — POST /score/property

Calcule le score Foncik pour une annonce caractérisée par son adresse, sa surface, son prix, son type et (optionnellement) sa classe DPE.

curl -X POST https://api.foncik.fr/score/property 
  -H "Content-Type: application/json" 
  -d '{
    "address": "12 rue Paradis 13001 Marseille",
    "surface_m2": 65,
    "price_eur": 245000,
    "type": "appartement",
    "dpe": "D"
  }'

Réponse :

{
  "score": 78,
  "verdict": "bonne_affaire",
  "price_per_m2": 3769,
  "median_local_per_m2": 3614,
  "delta_pct": 4.3,
  "dpe_consistency": "ok",
  "yield_brut_pct": 5.1,
  "risks": ["argile_modere"],
  "comparables_count": 412,
  "updated_at": "2026-04-25"
}

2. Statistiques d’une commune — GET /enrichi/commune/{insee}

Renvoie les indicateurs agrégés Foncik pour une commune donnée (médiane, surface, mutations, distribution énergétique, loyer estimé).

curl https://api.foncik.fr/enrichi/commune/13055

3. Carte de chaleur d’une commune — GET /heatmap/commune/{insee}

Renvoie les zones (IRIS pour les villes > 50 000 hab., quartier officiel sinon) avec leurs polygones GeoJSON et leurs statistiques agrégées.

curl https://api.foncik.fr/heatmap/commune/69123

4. Risques d’une adresse — GET /risques/{lat}/{lng}

Renvoie l’exposition aux risques naturels et technologiques pour un point géographique précis.

curl https://api.foncik.fr/risques/43.2803/5.3806

Spécification OpenAPI

La spec complète est disponible sur api.foncik.fr/openapi.json. Sandbox interactive Swagger UI : api.foncik.fr/docs.

Tarifs prévus (à partir de mai 2026)

  • Bêta gratuite — jusqu’au 26 mai 2026, 60 req/min par IP, sans clé.
  • Free — 1 000 requêtes/mois, clé requise.
  • Indie — 9 €/mois, 50 000 requêtes/mois, support email 48h.
  • Pro — 49 €/mois, 500 000 requêtes/mois, SLA 99,5%, support email 24h.
  • Enterprise — sur devis, quotas illimités, hébergement dédié possible.

Pour réserver une clé bêta avec quotas étendus : bonjour@foncik.fr.