Recursos
Diccionario de variables de GDELT
Guía de las tablas, actores, códigos CAMEO y campos principales de la base de eventos de GDELT.
Tres tablas, un ecosistema
GDELT (Global Data on Events, Location, and Tone) actualiza cada 15 minutos un repositorio de noticias de prensa, radio y televisión en más de cien idiomas. Los datos se organizan en tres tablas relacionadas:
- Event Database (v2.0). Interacciones diádicas codificadas como sujeto-acción-objeto: quién hizo qué a quién, dónde y cuándo.
- Global Knowledge Graph (GKG v2). Temas, entidades, sentimiento, citas y recuentos de conceptos extraídos del documento completo.
- Event Mentions Table. Conecta cada evento con las noticias posteriores que lo mencionan.
Las tres se pueden unir por identificadores comunes. La clave está en entender qué representa cada nivel: el evento es la acción codificada; el GKG es el contexto temático del documento; las menciones son la vida mediática del evento.
Event Database v2.0
Cada registro de evento incluye 61 columnas organizadas en cinco bloques: identificadores y fechas, atributos de los actores, acción CAMEO, métricas de impacto mediático y geolocalización.
Actores
Un actor no es solo un país. Es una cadena de hasta diez caracteres que combina afiliación geográfica, grupo étnico, religión y rol político. Por ejemplo, USACOPGOV se descompone en:
USA: país.COP: rol (fuerzas policiales).GOV: tipo de actor (gobierno).
Acción CAMEO
El EventCode clasifica la interacción en un árbol taxonómico de tres niveles:
EventRootCode: categoría general, por ejemplo14(protestar).EventBaseCode: subcategoría, por ejemplo141(demostrar o hacer huelga).EventCode: acción específica, por ejemplo1411(protesta contra la represión estatal).
Métricas mediáticas
NumMentions: número de veces que el evento aparece en los artículos del ciclo de 15 minutos.NumSources: número de medios distintos que publican la noticia.AvgTone: tono afectivo del texto, en una escala aproximada de -100 a +100.
Geolocalización
GDELT asigna coordenadas al evento (ActionGeo) y a cada actor (Actor1Geo, Actor2Geo). El campo de tipo indica el nivel de resolución: país, provincia, ciudad o punto específico. Las coordenadas permiten análisis GIS y agregaciones subnacionales.
Global Knowledge Graph
El GKG procesa el documento completo, no solo la triada de acción. Sus campos principales incluyen:
V2Themes: lista de temas taxonómicos, comoTAX_ETHNICITY,CRISISLEX_CRISIS_RESPONSE,AUTOCRACY,ELECTIONoMILITARY.V2PersonsyV2Organizations: nombres de figuras públicas y organizaciones con su posición en el documento.GCAM: más de veinte diccionarios psicológicos y analíticos (LIWC, WordNet, Regressive Imagery Dictionary) para medir emociones, ansiedad, certeza o encuadre.V2Quotations: declaraciones entrecomilladas, con el orador, el verbo de cita y el texto.
Mentions Table
La tabla de menciones permite seguir el ciclo de vida mediático de un evento:
GLOBALEVENTID: conecta con la Event Database.MentionTimeDate: momento en que el medio citó el evento.SentenceID: oración del artículo donde aparece la mención.Confidence: certeza del algoritmo de que la mención corresponde al evento original.
CAMEO, QuadClass y Goldstein
CAMEO clasifica las acciones en cuatro macro-categorías (QuadClass) y les asigna un valor de conflicto o cooperación (GoldsteinScale, de -10 a +10):
| QuadClass | Tipo | Rango Goldstein | Ejemplos |
|---|---|---|---|
| 1 | Cooperación verbal | +1,0 a +6,0 | Declaraciones, negociaciones, visitas diplomáticas. |
| 2 | Cooperación material | +3,0 a +10,0 | Ayuda humanitaria, cooperación militar, acuerdos. |
| 3 | Conflicto verbal | -1,0 a -5,0 | Acusaciones, amenazas, demandas de dimisión. |
| 4 | Conflicto material | -5,0 a -10,0 | Protestas, represión, violencia física, estados de sitio. |
La escala es una ponderación teórica, no una medida empírica de daño. Se usa para construir índices de estabilidad o conflicto, siempre con cautela.
Diccionario de variables
| Variable | Tabla | Tipo | Uso |
|---|---|---|---|
GLOBALEVENTID |
events | entero | Clave primaria para unir eventos y menciones. |
SQLDATE |
events | entero YYYYMMDD |
Filtrado y agrupación temporal. |
Actor1Code |
events | texto | Identidad geográfica, étnica, religiosa o de rol del actor. |
Actor1Name |
events | texto | Nombre en claro del actor. |
Actor1CountryCode |
events | texto ISO-3 | Afiliación territorial del actor. |
EventCode |
events | texto CAMEO | Acción específica. |
QuadClass |
events | entero 1-4 | Macro-categoría de cooperación o conflicto. |
GoldsteinScale |
events | decimal -10 a +10 | Impacto teórico sobre la estabilidad. |
NumMentions |
events | entero | Intensidad de cobertura del evento. |
AvgTone |
events | decimal -100 a +100 | Tono afectivo medio. |
ActionGeo_Lat / ActionGeo_Long |
events | decimal | Coordenadas del evento. |
GKGRECORDID |
gkg | texto | Identificador del documento en el GKG. |
V2Themes |
gkg | texto | Temas taxonómicos del documento. |
GCAM |
gkg | texto | Diccionarios psicológicos y de encuadre. |
V2Quotations |
gkg | texto | Citas textuales con orador y verbo. |
MentionTimeDate |
mentions | fecha | Momento de la mención del evento. |
Buenas prácticas
- Normaliza la frecuencia de eventos por el volumen de noticias del país-año. Sin normalización, un cambio en el número de fuentes parece un cambio en el conflicto.
- Triangula GDELT con bases depuradas manualmente (ACLED, ICEWS, SCAD) cuando el diseño lo permita.
- Trata la actualización de 2014 como un quiebre de serie.
- No interpretes una caída de eventos como pacificación: puede ser censura o menor cobertura.
- Documenta la versión, la consulta y la fecha de descarga.