API de datos

Los 77 indicadores del sitio, para las 346 comunas, las 16 regiones y el país, listos para que otros programas los lean directamente. No hay que registrarse ni pedir una clave.

Cómo funciona

La API es un conjunto de archivos JSON y CSV que se generan con el sitio, cada vez que una fuente publica datos nuevos. Se pueden leer desde cualquier lenguaje o desde el navegador (permiten consultas desde otros sitios). La dirección base es:

https://observatoriopublico.cl/api/v1/

Cada respuesta trae la fecha en que se generó (generado) y, para cada indicador, su unidad, el período publicado, el estado de cada valor, la fuente con la fecha de su última versión, la licencia y el enlace a la metodología.

Recursos

Archivo	Qué trae
`index.json`	La lista de recursos y la fecha de generación.
`indicadores.json`	Todos los indicadores con su descripción, cálculo, unidad, períodos, fuente, versión de la fuente, licencia, advertencias y cambios en la serie.
`indicadores/{id}.json`	Todos los valores de un indicador, en todos sus años, para comunas, regiones y el país, con numerador, denominador, estado y notas.
`indicadores/{id}.csv`	Lo mismo en CSV (UTF-8, sin BOM, separado por comas), con la unidad, la fuente y la licencia en cada fila.
`comunas/{cut}.json`	Todo de una comuna: sus datos, los de su región y el país para comparar, y su alcaldía y concejo actuales.
`territorios.json`	Regiones, provincias y comunas con su código CUT, nombre y página.
`fuentes.json`	Las fuentes, sus condiciones de uso, cómo citarlas y qué indicadores vienen de cada una.

El {id} de cada indicador está en indicadores.json y en la dirección de su página (por ejemplo, /indicador/sinim_gasto_pc/). El {cut} es el código territorial de cinco dígitos (por ejemplo, 09101 es Temuco).

Los valores

nivel: comuna, region o pais.
codigo: Código CUT de la comuna (5 dígitos) o de la región (2), o CL.
periodo: El año (o la elección) al que corresponde el dato.
valor: El indicador, en la unidad del indicador. Puede ser null si la fuente no lo informa.
numerador, denominador: Con qué se calculó, cuando el indicador es una razón.
estado: observado (el caso normal), preliminar (preliminar), estimado (estimado), proyectado (proyección), en_revision (en revisión).
dudoso: true si el valor parece un error de lo informado a la fuente: se publica, pero no entra en rankings ni mapas.
nota: Una aclaración de la fuente o del cálculo, si la hay.
limite_inferior, limite_superior: El intervalo de confianza, cuando el valor es una estimación con margen de error (la pobreza de Casen). Si no hay, van vacíos o no aparecen.

Ejemplos

En la terminal

curl -s https://observatoriopublico.cl/api/v1/comunas/09101.json

Python (pandas)

import pandas as pd
gasto = pd.read_csv("https://observatoriopublico.cl/api/v1/indicadores/sinim_gasto_pc.csv", dtype={"codigo": str})
comunas = gasto[(gasto.nivel == "comuna") & ~gasto.dudoso]

R

gasto <- read.csv("https://observatoriopublico.cl/api/v1/indicadores/sinim_gasto_pc.csv", colClasses = c(codigo = "character"))
comunas <- subset(gasto, nivel == "comuna" & !dudoso)

JavaScript

const r = await fetch("https://observatoriopublico.cl/api/v1/indicadores/sinim_gasto_pc.json");
const { indicador, valores } = await r.json();

Lee el código CUT como texto: algunos empiezan con cero (01101 es Iquique).

Licencias, versiones y cuidados

Cada dato lleva la licencia de su fuente (campo licencia): los de SINIM solo permiten usos sin fines comerciales, y los del INE exigen compartir lo derivado con la misma licencia. Detalle en las condiciones de uso.
La versión v1 no cambia de forma: se pueden agregar campos o archivos, pero ninguno se quita ni cambia de sentido. Si algún día hace falta, habrá una v2 y la v1 seguirá disponible un tiempo.
Los datos sí cambian: cuando llega un año nuevo o una fuente corrige cifras ya publicadas. Las correcciones quedan en Correcciones y en las novedades (también por RSS).
Para citar un análisis hecho con la API, usa la fecha de generado y la cita de cada fuente (fuentes.json). Si necesitas una versión fija, descarga los paquetes con fecha de Datos abiertos.
No hay límite de consultas, pero los archivos cambian a lo más unas pocas veces al mes: guárdalos en tu programa en vez de pedirlos en cada uso.