Aller au contenu principal

Questions fréquentes (FAQ)

Retrouvez ici les réponses aux questions les plus fréquentes sur l'API Infoparcelle.

Généralités​

Qu'est-ce que l'API Infoparcelle ?​

L'API Infoparcelle est une API REST qui agrège et structure des données publiques françaises (cadastre, transactions immobilières, DPE, permis de construire, etc.) pour faciliter l'analyse territoriale et les projets immobiliers.

Quelles sont les sources de données ?​

L'API agrège des données provenant de multiples sources officielles :

  • DGFiP : Cadastre et transactions (DVF)
  • ADEME : Diagnostics de performance énergétique (DPE)
  • Géorisques : Permis de construire
  • INPI : Propriétaires et copropriétés
  • INSEE : Données territoriales

À quelle fréquence les données sont-elles mises à jour ?​

Les données sont actualisées régulièrement selon les sources :

  • Cadastre : Mensuel
  • DVF : Semestriel
  • DPE : Quotidien
  • Permis de construire : Hebdomadaire

Tarification​

Quels sont les plans disponibles ?​

PlanCrédits/moisAppels standardsPrix
🌱 Starter5 000~50025€/mois
🚀 Business25 000~2 500100€/mois
💼 Pro50 000~5 000200€/mois
🏢 Enterprise250 000~25 000750€/mois
🌟 Scale500 000~50 0001 250€/mois
🚀 Enterprise+1 000 000+~100 000+Sur mesure

Voir tous les plans →

Que se passe-t-il si je dépasse mon quota ?​

Vous avez deux options :

  1. Activer les dépassements : Paiement à l'usage au-delà du quota
  2. Passer à un plan supérieur : Augmenter votre quota mensuel

Sans dépassement activé, l'API retournera une erreur 434 Quota Exceeded.

Y a-t-il une période d'essai gratuite ?​

Oui, nous offrons 200 requêtes gratuites pour tester l'API. Aucune carte bancaire requise.

Créer un compte →

Puis-je changer de plan à tout moment ?​

Oui, vous pouvez changer de plan (upgrade ou downgrade) à tout moment depuis votre espace compte. Les changements prennent effet immédiatement.

Technique​

Comment obtenir une clé API ?​

  1. Créez un compte sur infoparcelle.fr
  2. Souscrivez à un plan API
  3. Générez une clé depuis votre espace compte

Guide complet →

Quelle est la limite de débit ?​

1200 requêtes par minute (soit 20 requêtes par seconde).

Si vous dépassez cette limite, vous recevrez une erreur 429 Too Many Requests.

En savoir plus sur les limites →

Comment gérer la pagination ?​

L'API utilise une pagination par curseur. Utilisez le header X-Pagination-Next-Cursor pour récupérer la page suivante.

const response = await fetch(url);
const data = await response.json();

const nextCursor = response.headers.get('X-Pagination-Next-Cursor');
const hasMore = response.headers.get('X-Pagination-Has-More') === 'true';

if (hasMore) {
  // Récupérer la page suivante avec le curseur
}

L'API fonctionne-t-elle en HTTPS uniquement ?​

Oui, toutes les requêtes doivent utiliser HTTPS. Les requêtes HTTP sont automatiquement redirigées vers HTTPS.

Puis-je utiliser l'API depuis un navigateur ?​

Oui, mais uniquement côté serveur. Ne jamais exposer votre clé API côté client (JavaScript frontend) pour des raisons de sécurité.

Pour une utilisation côté client, créez un proxy backend qui gère l'authentification.

Données et couverture​

Quelle est la couverture géographique ?​

L'API couvre la France métropolitaine et les départements d'outre-mer (DOM).

Les adresses incluent-elles les coordonnées GPS ?​

Oui, chaque adresse retourne un point GPS (GeoJSON Point) avec latitude et longitude.

{
  "adresse_complete": "7 Rue de l'Elysée 75008 Paris",
  "centre": {
    "type": "Point",
    "coordinates": [2.316667, 48.870556]
  }
}

Puis-je obtenir les géométries complètes des parcelles ?​

Oui, utilisez le paramètre geometrie=contour pour obtenir le polygone complet :

curl "https://app.infoparcelle.fr/api/v1/parcelles/12345?geometrie=contour"

Les données DVF incluent-elles tous les types de biens ?​

Oui, les données DVF incluent :

  • Maisons
  • Appartements
  • Terrains
  • Locaux commerciaux
  • Dépendances

Comment rechercher une adresse approximative ?​

L'endpoint de géocodage utilise un algorithme de similarité. Il suffit de fournir une adresse partielle :

curl "https://app.infoparcelle.fr/api/v1/geocoder/search?recherche=Elysée+Paris"

Chaque résultat inclut un score de similarité (0-1).

Puis-je utiliser l'API avec Postman ?​

Oui ! Postman peut importer directement notre spécification OpenAPI :

  1. Téléchargez le fichier OpenAPI depuis la page API Reference (boutons "📥 Download JSON" ou "📥 Download YAML")
  2. Dans Postman, cliquez sur Import → File → Sélectionnez le fichier téléchargé
  3. Postman va automatiquement créer une collection avec tous les endpoints

Vous pouvez aussi importer directement via URL :

  • JSON : https://docs.infoparcelle.fr/openapi.json
  • YAML : https://docs.infoparcelle.fr/openapi.yaml

Sécurité​

Comment sécuriser ma clé API ?​

  • ✅ Stockez-la dans des variables d'environnement
  • ✅ Ne la commitez jamais dans Git
  • ✅ Utilisez différentes clés par environnement
  • ✅ Révoquez immédiatement toute clé compromise

Bonnes pratiques →

Puis-je restreindre l'utilisation de ma clé API ?​

Actuellement, les restrictions par IP ou domaine ne sont pas disponibles. Contactez-nous pour des besoins spécifiques en sécurité.

Que faire si ma clé API est compromise ?​

  1. Supprimez immédiatement la clé depuis votre espace compte
  2. Générez une nouvelle clé
  3. Mettez à jour vos applications

Performance​

Quel est le temps de réponse moyen ?​

Le temps de réponse moyen est < 200ms pour la plupart des endpoints.

Puis-je mettre en cache les résultats ?​

Oui, nous recommandons de cacher les données peu volatiles :

  • Géométries des territoires : Cache long (plusieurs jours)
  • Parcelles cadastrales : Cache moyen (1 jour)
  • Adresses : Cache court (quelques heures)
  • Transactions DVF : Cache court (1 heure)

Comment optimiser mes requêtes ?​

  1. Utilisez le paramètre champs pour ne récupérer que les données nécessaires
  2. Limitez le nombre de résultats avec limite
  3. Privilégiez geometrie=centre au lieu de contour
  4. Implémentez un cache pour les données peu volatiles
  5. Espacez vos requêtes pour respecter le rate limit

Guide d'optimisation →

Support​

Comment obtenir de l'aide ?​

Comment signaler un bug ?​

Cas d'usage​

Puis-je utiliser l'API pour une application commerciale ?​

Oui, l'API peut être utilisée pour des applications commerciales. Consultez nos CGU pour plus de détails.

Puis-je redistribuer les données ?​

Les données peuvent être utilisées dans vos applications mais ne peuvent pas être redistribuées telles quelles. Consultez nos CGU.

L'API est-elle adaptée pour une analyse de marché immobilier ?​

Oui ! L'API est particulièrement adaptée pour :

  • Analyse de marché et pricing
  • Recherche de biens
  • Études de zonage
  • Valorisation de patrimoine

Question non répertoriée ?​

Si vous ne trouvez pas de réponse à votre question :