API pública - DatosClaros

🆓 Uso libre bajo CC BY 4.0

Puedes usar los datos para investigación, periodismo, apps o tu TFG. Solo cita "DatosClaros" como fuente.

Endpoints disponibles

📥 Leer datos (GET, público)

GET https://datosclaros.es/api.php?accion=leer&seccion={seccion}

Devuelve el JSON completo de la sección. Sin autenticación.

📄 Descargar CSV

GET https://datosclaros.es/api.php?accion=descargar_csv&seccion={seccion}

Devuelve CSV con BOM UTF-8, separador ; (se abre bien en Excel español).

📦 Descargar JSON

GET https://datosclaros.es/api.php?accion=descargar_json&seccion={seccion}

📋 Listar secciones disponibles

GET https://datosclaros.es/api.php?accion=secciones

Secciones disponibles (32)

Sección (parámetro)	Nombre	Leer	CSV	JSON
`pisos`	Pisos vacíos	leer	csv	json
`impuestos`	Impuestos (PGE)	leer	csv	json
`vivienda`	Vivienda vs sueldo	leer	csv	json
`comparador`	Comparador sueldos	leer	csv	json
`irpf_ccaa`	IRPF por CCAA	leer	csv	json
`votaciones`	Votaciones Congreso	leer	csv	json
`diputados`	Diputados	leer	csv	json
`midiputado`	Mi diputado (circunscripciones)	leer	csv	json
`promesas`	Promesas electorales	leer	csv	json
`judicial`	Responsabilidad judicial	leer	csv	json
`timeline`	Timeline eventos	leer	csv	json
`pension`	Pensión	leer	csv	json
`alquiler`	Alquilar vs comprar	leer	csv	json
`inflacion`	Inflación	leer	csv	json
`costevida`	Coste de vida	leer	csv	json
`eu`	España vs UE	leer	csv	json
`comparador_ccaa`	Comparador CCAA	leer	csv	json
`brecha`	Brecha salarial	leer	csv	json
`empleo`	Empleo	leer	csv	json
`sanidad`	Sanidad	leer	csv	json
`educacion`	Educación	leer	csv	json
`medioambiente`	Medio ambiente	leer	csv	json
`democracia`	Democracia	leer	csv	json
`licencias`	Licencias software	leer	csv	json
`opensource`	Open source	leer	csv	json
`empresastic`	Empresas TIC	leer	csv	json
`puertas`	Puertas giratorias	leer	csv	json
`justicia`	Sistema judicial	leer	csv	json
`salud`	Salud pública	leer	csv	json
`demografia`	Demografía	leer	csv	json
`movilidad`	Movilidad	leer	csv	json
`quiz`	Quiz	leer	csv	json

Ejemplos de uso

JavaScript (fetch)

const r = await fetch('https://datosclaros.es/api.php?accion=leer&seccion=pisos');
const datos = await r.json();
console.log(datos.ciudades);

Python (requests)

import requests
r = requests.get('https://datosclaros.es/api.php', params={'accion':'leer','seccion':'impuestos'})
datos = r.json()
print(datos['categorias_gasto'])

curl (CSV)

curl "https://datosclaros.es/api.php?accion=descargar_csv&seccion=comparador" -o sueldos.csv

Python (pandas DataFrame)

import pandas as pd
df = pd.read_csv('https://datosclaros.es/api.php?accion=descargar_csv&seccion=pisos', sep=';')
print(df.head())

Formato de respuesta

Todas las respuestas JSON tienen estructura:

{
  "metadata": {
    "titulo": "...",
    "fecha_actualizacion": "2026-04-20",
    "fuente": "..."
  },
  // datos específicos de cada sección
}

⚖️ Términos de uso

✅ Uso libre gratuito bajo CC BY 4.0
✅ Cita "DatosClaros" como fuente
✅ Puedes comercializar productos que usen estos datos
⚠️ No abuses del servidor (rate limit informal: <60 peticiones/minuto)
⚠️ Para integraciones masivas, descarga el JSON y cachea en tu servidor
❌ No reclames autoría de los datos

🔌 API pública