Api

El API es una herramienta que permite consultar de forma automatizada el Catálogo de datos en base a unos criterios elegidos por el usuario y utilizando identificadores uniformes de recursos (URI).

Formatos de respuesta

La información disponible en el API puede obtenerse en diferentes formatos. Los formatos disponibles son: json, xml, rdf, ttl y csv

Si se accede a un recurso de API a través del navegador, por ejemplo http://datos.gob.es/apidata/catalog/dataset, se verá el resultado en formato JSON.

Hay dos opciones para indicar el tipo de respuesta que se desea:

Mediante el parámetro 'Accept' en las cabeceras de la petición. Por ejemplo: Accept:application/rdf+xml

Indicando el formato mediante su extensión en la petición. Por ejemplo: http://datos.gob.es/apidata/catalog/dataset.xml

En esta tabla se pueden ver todos los formatos y cómo llamarlos de ambas formas:

FormatoHeader 'Accept'Extensión de formato
JSONapplication/json.json
XMLapplication/xml.xml
RDFapplication/rdf+xml.rdf
Turtleapplication/x-turtle.turtle
CSVtext/csv.csv

Parámetros API

La API ofrece una serie de párametros para personalizar la petición obteniendo mejores resultados:

ParámetroDescripción
_sort Con este parámetro se pueden ordenar los resultados.
Su valor debe ser cualquiera de los campos que contienen los resultados.
Para invertir el orden hay que añadir el simbolo menos '-'.
Se pueden combinar varios campos usando la coma ',' como separador.
Por ejemplo, para obtener todos los dataset ordenados por fecha descendente y titulo:"http://datos.gob.es/apidata/catalog/dataset.json?_sort=-issued,title"
_pageSize Este parámetro se utiliza para fijar el número de resultados por página.
El valor máximo es 50.
Por ejemplo, para obtener los resultados de uno en uno:"http://datos.gob.es/apidata/catalog/dataset.xml?_pageSize=1"
_page Este parámetro se utiliza para indicar el número de página en el que nos encontramos.
La página inicial es 0.
Por ejemplo, para estar en la tercera página: "http://datos.gob.es/apidata/catalog/dataset.xml?_pageSize=1&_page=2"

Catálogo de llamadas disponibles

Conjuntos de datos

Todos

http://datos.gob.es/apidata/catalog/dataset

Conjunto de datos con un determinado identificador de URI

http://datos.gob.es/apidata/catalog/dataset/{id}
Se debe especificar el valor de {id}.
Por ejemplo, si el {id} tiene el valor 'a16003011-empresas-y-personas-empleadas-en-la-c-a-de-euskadi-supervivientes-en-2015-altas-en-los-cinco-anos-anteriores-por-territorio-y-comarca-de-sede-social', la llamada será: http://datos.gob.es/apidata/catalog/dataset/a16003011-empresas-y-personas-empleadas-en-la-c-a-de-euskadi-supervivientes-en-2015-altas-en-los-cinco-anos-anteriores-por-territorio-y-comarca-de-sede-social

Conjunto de datos con un determinado titulo

http://datos.gob.es/apidata/catalog/dataset/title/{title}
Se debe especificar el valor de {title}. Puede ser parte del título.
Por ejemplo, si {title} tiene el valor: 'empleo', la llamada será: http://datos.gob.es/apidata/catalog/dataset/title/{title}

Conjunto de datos con un determinado publicador a través de su identificador

http://datos.gob.es/apidata/catalog/dataset/publisher/{id}
Se debe especificar el valor de {id}.
Por ejemplo, si {id} tiene el valor: 'A16003011', la llamada será: http://datos.gob.es/apidata/catalog/dataset/publisher/A16003011

Conjunto de datos con un determinado tema a través de su identificador

http://datos.gob.es/apidata/catalog/dataset/theme/{id}
Se debe especificar el valor de {id}.
Por ejemplo, si {id} tiene el valor: 'hacienda', la llamada será: http://datos.gob.es/apidata/catalog/dataset/theme/hacienda

Conjunto de datos que contienen recursos con un determinado formato

http://datos.gob.es/apidata/catalog/dataset/format/{format}
Por ejemplo, si {format} tiene el valor: 'csv', la llamada será: http://datos.gob.es/apidata/catalog/dataset/format/csv

Conjunto de datos que contienen una determinada palabra clave:

http://datos.gob.es/apidata/catalog/dataset/keyword/{keyword}
Si {keyword} tiene el valor: 'gastos', la llamada será: http://datos.gob.es/apidata/catalog/dataset/keyword/gastos

Conjunto de datos que pertenecen un determinado ambito geográfico:

http://datos.gob.es/apidata/catalog/dataset/spatial/{spatialWord1}/{spatialWord2}
En esta llamada se utilizan dos parámetros: {spatialWord1} y {spatialWord2}
Si {spatialWord1} tiene el valor: 'Autonomia' y {spatialWord2} tiene el valor: 'Pais-Vasco' la llamada será: http://datos.gob.es/apidata/catalog/dataset/spatial/Autonomia/Pais-Vasco

Conjunto de datos que modificados entre dos fechas:

http://datos.gob.es/apidata/catalog/dataset/modified/begin/{beginDate}/end/{endDate}
En esta llamada se utilizan dos parámetros: {beginDate} y {endDate}, cuyo formato debe ser AAAA-MM-DDTHH:mmZ
Si {beginDate} tiene el valor: 2016-04-18T00:00Z y {endDate} tiene el valor: 2016-06-30T00:00Z la llamada será: http://datos.gob.es/apidata/catalog/dataset/modified/begin/2016-04-18T00:00Z/end/2016-06-30T00:00Z?_sort=title&_pageSize=10&_page=0

Recursos

Todos

http://datos.gob.es/apidata/catalog/distribution

Recursos de un conjunto de datos identificado por el identificador de URI

http://datos.gob.es/apidata/catalog/distribution/dataset/{id}
Se debe especificar el valor de {id}.
Por ejemplo, si el {id} tiene el valor 'a16003011-empresas-y-personas-empleadas-en-la-c-a-de-euskadi-supervivientes-en-2015-altas-en-los-cinco-anos-anteriores-por-territorio-y-comarca-de-sede-social', la llamada será: http://datos.gob.es/apidata/catalog/distribution/dataset/a16003011-empresas-y-personas-empleadas-en-la-c-a-de-euskadi-supervivientes-en-2015-altas-en-los-cinco-anos-anteriores-por-territorio-y-comarca-de-sede-social

Recursos con un determinado formato

http://datos.gob.es/apidata/catalog/distribution/format/{format}
Si {format} tiene el valor: 'csv', la llamada será:
http://datos.gob.es/apidata/catalog/distribution/format/csv

Publicadores

Todos

http://datos.gob.es/apidata/catalog/publisher

Ambitos geográficos

Todos

http://datos.gob.es/apidata/catalog/spatial

Temas

Todos

http://datos.gob.es/apidata/catalog/theme