API del atlas de eventos

Archivos de la versión 1

Versión 2: consultas y base completa

La versión 2 responde consultas con filtros y entrega la base completa, lista para analizar con DuckDB, Python, R o una planilla. Cada respuesta trae la licencia y la nota de cobertura. Las mismas reglas valen para las dos versiones: ningún campo de persona, y la fuente de cada dato a la vista.

import sqlite3, urllib.request
urllib.request.urlretrieve("https://datacultura.org/atlas/api/v2/descargas/eventos.sqlite", "eventos.sqlite")
sqlite3.connect("eventos.sqlite").execute("SELECT region, anio, ediciones FROM ediciones_por_region_anio").fetchall()

Cómo se lee un campo

Una serie es el evento que se repite y una edición es cada realización. Cada campo es un objeto con su valor en v y el identificador del documento fuente en f. Un campo que la fuente no trae no aparece: el atlas no completa fechas, años ni números de edición por su cuenta. El campo estado copia lo que dice la fuente, como una cancelación; si no está, la fuente no dijo nada sobre si la edición se realizó.

{
  "registro_id": "edi:EDI-30005",
  "serie": "evt:EVT-30002",
  "titulo": {
    "v": "primer Festival de Viña del Mar",
    "f": "doc-bn-memoriachilena-2c984834ca",
    "cita": "El primer Festival de Viña del Mar fue organizado por Carlos Ansaldo por petición de la Municipalidad de Viña del Mar, para promover la ciudad balneario. Se llevó a cabo la última semana de febrero de 1960"
  },
  "anio": {
    "v": 1960,
    "f": "doc-bn-memoriachilena-2c984834ca",
    "cita": "El primer Festival de Viña del Mar fue organizado por Carlos Ansaldo por petición de la Municipalidad de Viña del Mar, para promover la ciudad balneario. Se llevó a cabo la última semana de febrero de 1960"
  },
  "comunas": {
    "v": [
      "05109"
    ],
    "f": "doc-bn-memoriachilena-2c984834ca",
    "cita": "El primer Festival de Viña del Mar fue organizado por Carlos Ansaldo por petición de la Municipalidad de Viña del Mar, para promover la ciudad balneario. Se llevó a cabo la última semana de febrero de 1960"
  },
  "numero_edicion": {
    "v": 1,
    "f": "doc-bn-memoriachilena-2c984834ca",
    "cita": "El primer Festival de Viña del Mar fue organizado por Carlos Ansaldo por petición de la Municipalidad de Viña del Mar, para promover la ciudad balneario. Se llevó a cabo la última semana de febrero de 1960"
  },
  "origen": "curacion"
}

Ejemplos

Con la terminal:

curl -s https://datacultura.org/atlas/api/v1/ediciones.json | jq '.ediciones[] | {titulo: .titulo.v, anio: .anio.v}'

Con Python y pandas:

import pandas as pd
ediciones = pd.read_csv("https://datacultura.org/atlas/api/v1/ediciones.csv", dtype={"comunas": str})
ediciones.groupby(["anio", "region"]).size()

Con JavaScript, desde cualquier sitio (la API responde con CORS abierto):

const r = await fetch("https://datacultura.org/atlas/api/v1/eventos.json");
const { series, documentos } = await r.json();

Versiones

La dirección lleva la versión. Dentro de cada versión se pueden sumar campos opcionales, pero ninguno cambia de nombre ni de significado. La versión 2 suma consultas y la base completa; la 1 sigue publicada igual. Los identificadores evt: y edi: no cambian ni se reutilizan, y cada archivo trae su fecha_de_corte.

Qué no trae

• Ningún campo con nombres de personas, ni descripciones, afiches, fotos u opiniones.
• Las ediciones cuyo título nombra a una persona: se consultan solo en su página del atlas.
• Asistencia, públicos o impacto: ninguna fuente pública los trae de forma comparable.

Cobertura

Ediciones publicadas en las fuentes que consultamos. Sin registro no significa que no exista: sume la suya. Las fuentes son las páginas de los organizadores y de instituciones públicas, leídas por una persona y guardadas con su captura. Representan mejor lo que tiene sitio web y menos lo comunitario o lo anunciado solo en redes sociales. La nota de método completa está en Acerca de los datos.

Licencia y cómo citar

Las tablas y su selección se publican bajo Creative Commons Atribución 4.0 Internacional. Los títulos de los eventos son de sus organizadores y se reproducen para identificarlos; la licencia no da derechos sobre ellos. Cite así:

Data Cultura (2026). Atlas de eventos culturales de Chile, versión 1. https://datacultura.org/atlas/api/v1/

Si retiramos una edición a pedido de una persona u organización, aparece en retiros.csv con la fecha: le pedimos que la quite también de su copia.