Datos abiertos y API

Publicamos el registro completo de ZBE bajo licencia CC BY 4.0. Es el activo central del proyecto: 22 fichas verificadas con sus fuentes (última verificación: 2026-08-19). Los datos se generan de forma dinámica, siempre al día.

Descargas

zbe-espana.jsonTodas las fichas + metadatos.zbe-espana.geojsonPerímetros (FeatureCollection).

API para desarrolladores

API pública de solo lectura, sin autenticación y con CORS abierto. URL base:https://tucalle.es/api/v1

Método	Ruta	Descripción
GET	/api/v1/cities.json	Dataset completo (todas las fichas + metadatos). Filtros: ?status= y ?region=.
GET	/api/v1/cities/{slug}.json	Una ficha de ciudad por slug.
GET	/api/v1/cities.geojson	Perímetros disponibles (FeatureCollection).
GET	/api/v1/schema.json	JSON Schema del modelo de datos.

Ejemplos

curl "https://tucalle.es/api/v1/cities.json?status=active_enforcing"

const res = await fetch("https://tucalle.es/api/v1/cities.json");
const { cities } = await res.json();
console.log(cities.length, "ciudades con ZBE");

Parámetros de /cities.json: status (p. ej.active_enforcing) y region (comunidad autónoma). Valida contra el JSON Schema. Documentación completa en docs/api.md.

Licencia y atribución

Datos de TuCalle (https://tucalle.es), licencia CC BY 4.0. Consulta la licencia CC BY 4.0.

Preguntas frecuentes

¿Necesito una clave de API?

No. La API es abierta y de solo lectura (GET), con CORS habilitado para cualquier origen. Solo te pedimos citar la fuente.

¿Con qué frecuencia se actualizan los datos?

Los datos se generan dinámicamente desde las fichas vigentes en cada despliegue. Un pipeline diario revisa cambios normativos y judiciales.

¿Puedo usar los datos en un producto comercial?

Sí, bajo la licencia CC BY 4.0: puedes usarlos y redistribuirlos citando la fuente (Datos de TuCalle (https://tucalle.es), licencia CC BY 4.0.).

¿Hay límites de uso?

Hay un límite de peticiones por IP para proteger el servicio (responde 429 con Retry-After si se supera). Las respuestas se cachean; para volcados masivos usa los ficheros de descarga.