présentation
L'API du cadastre espagnol est basée sur le protocole SOAP de 2003. Pour faciliter l'accès à ces données, une API JSON a été créée. Cette API permet de récupérer des informations sur les biens immobiliers en Espagne de manière structurée et prévisible.
La source officielle du cadastre espagnol est difficile à consommer pour les machines en raison de son format SOAP/XML lourd et de ses erreurs qui ne respectent pas les codes HTTP. L'API proposée offre une alternative plus facile à utiliser.
fonctionnement
L'API fonctionne en utilisant une clé API pour authentifier les requêtes. Les erreurs de business ne sont pas facturées, mais les réponses mises en cache et les serve-stale le sont. L'API est conçue pour être résiliente en cas de chute de la source officielle.
Il existe trois façons d'accéder aux informations : par référence, par coordonnées ou par adresse. Les exemples de requêtes sont les suivants :
curl https://api.prediohq.com/v1/inmueble/9872023VH5797S0001WX -H "x-api-key: $PREDIO_API_KEY"curl "https://api.prediohq.com/v1/inmueble/by-coords?lat=41.3915&lon=2.1620" -H "x-api-key: $PREDIO_API_KEY"curl "https://api.prediohq.com/v1/inmueble/by-address?province=CIUDAD+REAL&municipality=SANTA+CRUZ+DE+MUDELA&streetType=CL&streetName=GLORIA&streetNumber=51" -H "x-api-key: $PREDIO_API_KEY"analyse scientifique
L'API est conçue pour être utilisée par les agents de proptech, les inmobiliarias et les agents d'IA. Elle offre une sortie versionnée et des erreurs prévisibles en JSON. Les données sont mises en cache pour éviter les problèmes de disponibilité.
Le modèle de tarification est basé sur le nombre de crédits utilisés. Les packs de crédits sont disponibles à des prix différents, allant de 0 € pour 250 crédits par mois à 99 € pour 150 000 crédits. Le coût par appel diminue à mesure que le nombre de crédits augmente.
implications et limites
L'API n'est pas officielle et ne garantit pas l'exactitude des données. Elle est conçue pour être utilisée dans le cadre de la législation espagnole sur la réutilisation des données publiques. Les utilisateurs doivent vérifier la licence de la Direction Générale du Cadastre pour leur cas d'utilisation spécifique.
L'API est limitée au territoire commun de l'Espagne, à l'exclusion du Pays Basque et de la Navarre, qui ont leur propre cadastre foral. Les données sont mises à jour régulièrement, mais les mises à jour peuvent être affectées par la disponibilité de la source officielle.
