Actualmente la plataforma Euskadi.eus ofrece la posibilidad de utilizar su buscador como si de un API REST se tratase. No es un API al uso, no existe un endpoint para las acciones, sino que se hacen peticiones al buscador directamente desde la URL. El mayor problema de esta forma de uso es la construcción correcta de la URL, ya que hay que conocer muy a fondo la estructura interna de Euskadi.eus para poder sacar provecho al buscador. Se puede consultar la documentación en PDF donde se detalla el formato de la URL..

Con la intención de hacer más fácil el uso del buscador como fuente de datos, se ha creado la librería Python Scodeu (Search Client for Open Data Euskadi). Es una librería open source que encapsula y abstrae el uso del buscador de Euskadi.eus. Su instalación es sencilla pues esta disponible desde Pypi.

Es importante recalcar que para poder sacar todo el partido de esta herramienta sigue siendo necesario conocer un poco el funcionamiento de Euskadi.eus a la hora de publicar informacion. Básicamente. cuando utilizamos el buscador accedemos a las fichas que describen el contenido, y desde esas fichas se hace referencia al contenido, por lo que es posible recuperarlas y procesarlas. La librería Scodeu nos devuelve el contenido de las fichas, con las que podremos acceder al contenido, pero a día de hoy es necesario conocer el formato/características del documento final para poder acceder a su contenidos.

En los talleres impartidos para presentar Open Data Euskadi se ha planteado un ejercicio para que los asistentes intentaran resolverlo con las herramientas que mejor conocieran. Este es el enunciado del ejercicio:

Recuperar todas las contrataciones del 2015 y recuperar la suma de lo que ha contratado cada departamento.

Y bueno, se puede ver la resolucion del ejercicio utilizando la libreria Scodeu.