Vue d'ensemble de l'API

L'API Infoparcelle est une API REST moderne donnant accès à des données foncières, cadastrales et immobilières pour la France.

Télécharger la spécification OpenAPI

Vous pouvez télécharger la spécification OpenAPI au format :

• JSON : Utilisez le bouton "Download" sur la page API Reference ou téléchargez directement
• YAML : Téléchargez le fichier YAML

Ces fichiers peuvent être importés dans Postman, Insomnia ou tout autre client API compatible.

Base URL

https://app.infoparcelle.fr/api/v1

Authentification

Toutes les requêtes nécessitent une authentification par clé API dans le header Authorization :

Authorization: Bearer VOTRE_CLE_API

En savoir plus sur l'authentification →

Endpoints principaux

Géocodage

• GET /geocoder/search - Rechercher des adresses
• GET /geocoder/ban/{identifiant_ban} - Obtenir une adresse par identifiant BAN
• GET /geocoder/coordinates - Géocodage inverse (coordonnées → adresse)

Parcelles cadastrales

• GET /parcelles/recherche - Recherche simple de parcelles
• POST /parcelles/recherche - Recherche de parcelles avec scoring
• GET /parcelles/{cadastre_id} - Obtenir une parcelle par ID cadastre
• GET /parcelles/previsualisation/{cadastre_id} - Prévisualiser une parcelle

Transactions DVF

• GET /dvfs - Rechercher des transactions immobilières

DPE (Diagnostics de Performance Énergétique)

• GET /dpes - Rechercher des diagnostics de performance énergétique

PLU (Plans Locaux d'Urbanisme)

• GET /plu - Rechercher dans les plans locaux d'urbanisme

Permis de construire

• GET /permis - Rechercher des permis de construire

Propriétaires et copropriétés

• GET /proprietaires - Rechercher des propriétaires
• GET /coproprietes - Rechercher des copropriétés
• GET /occupants - Rechercher des occupants

Territoires

• GET /regions - Liste des régions
• GET /departements - Liste des départements
• GET /municipalities - Liste des communes
• GET /epci - Liste des EPCI (Établissements Publics de Coopération Intercommunale)
• GET /sections - Liste des sections cadastrales
• GET /quartiers - Liste des quartiers

Formats de réponse

JSON (par défaut)

GET /api/v1/geocoder/search?recherche=1+Rue+de+Rivoli
Accept: application/json

[
  {
    "identifiant_ban": "75056_7560_00001",
    "adresse_complete": "1 Rue de Rivoli 75001 Paris",
    "centre": {
      "type": "Point",
      "coordinates": [2.3364, 48.8606]
    }
  }
]

GeoJSON

GET /api/v1/geocoder/search?recherche=1+Rue+de+Rivoli&format=geojson
Accept: application/json

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [2.3364, 48.8606]
      },
      "properties": {
        "identifiant_ban": "75056_7560_00001",
        "adresse_complete": "1 Rue de Rivoli 75001 Paris"
      }
    }
  ]
}

Paramètres communs

Pagination

Paramètre	Type	Description	Défaut
limite	integer	Nombre de résultats par page (max: 50)	10
curseur	string	Curseur de pagination	-

Sélection de champs

Paramètre	Type	Description
champs	array	Liste des champs à retourner (séparés par virgules)

Exemple :

/geocoder/search?recherche=Paris&champs=identifiant_ban,adresse_complete,centre

Tri

Paramètre	Type	Description	Défaut
champ_tri	string	Champ de tri	Dépend de l'endpoint
ordre_tri	string	Direction (asc ou desc)	desc

Géométries

Paramètre	Type	Description	Défaut
geometrie	string	Type de géométrie (centre, contour, bbox)	centre
format	string	Format de sortie (json, geojson)	json

Headers de réponse

Pagination

X-Pagination-Limit: 10
X-Pagination-Cursor: eyJpZCI6MTIzfQ==
X-Pagination-Next-Cursor: eyJpZCI6MTMzfQ==
X-Pagination-Has-More: true

Codes de statut HTTP

Code	Description
200	Succès
400	Requête invalide
401	Non authentifié
404	Ressource non trouvée
429	Trop de requêtes
434	Quota dépassé
500	Erreur serveur

Voir la gestion des erreurs →

Exemples de requêtes

Recherche d'adresse

curl -X GET \
  "https://app.infoparcelle.fr/api/v1/geocoder/search?recherche=7+Rue+de+l%27Elysée+Paris" \
  -H "Authorization: Bearer VOTRE_CLE_API"

Recherche de parcelle

curl -X GET \
  "https://app.infoparcelle.fr/api/v1/parcelles/recherche?code_municipalite=75108&section=AK&numero=0042" \
  -H "Authorization: Bearer VOTRE_CLE_API"

Recherche de transactions

curl -X GET \
  "https://app.infoparcelle.fr/api/v1/dvfs?code_municipalite=75108&valeur_fonciere_min=200000&valeur_fonciere_max=500000&champs=id_mutation,date_mutation,nature_mutation,bati_type,surface_batie,valeur_fonciere,municipalite" \
  -H "Authorization: Bearer VOTRE_CLE_API"

Limites et quotas

• 1200 requêtes par minute (20 req/s)
• Quotas mensuels selon votre plan :
  • 🌱 Starter : 5 000 crédits/mois (~500 appels)
  • 🚀 Business : 25 000 crédits/mois (~2 500 appels)
  • 💼 Pro : 50 000 crédits/mois (~5 000 appels)
  • 🏢 Enterprise : 250 000 crédits/mois (~25 000 appels)
  • 🌟 Scale : 500 000 crédits/mois (~50 000 appels)
  • 🚀 Enterprise+ : 1 000 000+ crédits/mois (~100 000+ appels)

En savoir plus sur les limites →

Prochaines étapes

• Recherche d'adresses - Documentation de l'endpoint de géocodage
• Gestion des erreurs - Comprendre les codes d'erreur
• Rate Limits - Limites de débit

Utilisez nos SDKs

Pour une intégration plus simple, utilisez nos SDKs officiels qui gèrent automatiquement l'authentification, la pagination et les erreurs !