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
_sortCon 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"
_pageSizeEste 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"
_pageEste 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