Global Database of Events, Language, and Tone
The Global Database of Events, Language, and Tone
|Start date||Around 2011|
|Focus||World events in real time|
Various acronyms and terms are used in the GDELT documentation. Since there seems to be no unified place for these on the GDELT website, we collect them here.
|GDELT||Global Database of Events, Language, and Tone||The project name||N/A|
|GKG||Global Knowledge Graph||One of the tables in GDELT|
|CAMEO||Conflict and Mediation Event Observations||????|
|CAMEO code||Conflict and Mediation Event Observations code||A defined code used in CAMEO||Example verbs: Express intent to institute political reform, not specified below (CAMEO 034), Allow humanitarian access (CAMEO 0863). Example actors: IGOUNO (the United Nations), COP (Police officers, officers, criminal investigative units, protective agencies). Example religions: ATH (Atheism/Agnosticism), CHR (Christianity).:22, 42, 93, 107|
|GCAM||GDELT Global Content Analysis Measures||????|
|Actor||N/A||An entity mentioned in an event||Barack Obama, Russia, Microsoft, United Church of Christ in Japan|
|Codebook||N/A||Documentation of the table schemas|
|LIWC||Linguistic Inquiry and Word Count|
|RID||?? mentioned in |
|GNS||mentioned in |
|GNIS||mentioned in |
|TABARI||Text Analysis By Augmented Replacement Instructions||N/A|
The GDELT versioning system is a little unclear. In one sense, there are three versions: 1.0, 2.0, and 3.0. However, for each release, the main dataset, the API, the Visual Knowledge Graph, and the GEO API (is this distinct from the API?) are released at separate times, so in another sense there are separate components each with their own versions (indeed, the GDELT Visual Knowledge Graph 2.0 is for GDELT 3.0).
|Release||Part of||Formats available||Year of publication||Month of publication||Years of coverage||Dimensions (inputs)||Metrics (outputs)|
|GDELT 1.0||GDELT 1.0||Raw data files, Google BigQuery||1979–present|
|GDELT 2.0||GDELT 2.0||Raw data files, Google BigQuery|
|GDELT Visual Knowledge Graph 1.0||Raw data files, Google BigQuery||2016||February||Images|
|GDELT Visual Knowledge Graph 2.0||GDELT 3.0||Google Cloud Vision API||2016||October||Images|
|GDELT 3.0||GDELT 3.0||2016/2017|
|GDELT GEO 2.0 API||2017||April|
GDELT 2.0 contains three tables: Events, Mentions, and the Global Knowledge Graph (GKG). In both Mentions and the GKG, each row in the table is an article about an event; the difference seems to be that the GKG contains more columns. On the other hand, in Events each row is an event, and only the first article that mentions the event is stored.
Data dimensions and metrics
GKG 2.0 fields from 
GDELT 2.0 Events and Mentions from 
|Table name||General field type||Field names giving information about the general field type|
|GKG 2.0||Date|| |
|GKG 2.0||Location|| |
|GKG 2.0||Entities|| |
|GKG 2.0||Topic|| |
|GKG 2.0||Sentiment|| |
|GKG 2.0||Source text|| |
|GDELT 2.0 Mentions||Date|| |
|GDELT 2.0 Mentions||Source text|| |
|GDELT 2.0 Mentions||Entities|| |
|GDELT 2.0 Mentions||Sentiment|| |
|GDELT 2.0 Events||Date|| |
|GDELT 2.0 Events||Entities|| |
|GDELT 2.0 Events||Sentiment|| |
|GDELT 2.0 Events||Source text|| |
|GDELT 2.0 Events||Location|| |
GDELT finds news articles through some process, but it's not clear what that process is.
From the about page:
Today GDELT relies on hundreds of thousands of broadcast, print, and online news sources from every corner of the globe in more than 100 languages and its source list grows daily. In addition to worldwide translated news material, the historical backfile of GDELT stretching back to 1979 makes extensive use of AfricaNews, Agence France Presse, Associated Press, Associated Press Online, Associated Press Worldstream, BBC Monitoring, Christian Science Monitor, Facts on File, Foreign Broadcast Information Service, The New York Times, United Press International and The Washington Post.
In addition to the actual news articles, some auxiliary data sources are used for sentiment analysis and location identification.
Methods of estimation
Usage in debates
- "CAMEO.Manual.1.1b3.pdf" (PDF). Retrieved October 17, 2017.
- "TABARI: Text Analysis By Augmented Replacement Instructions". Retrieved October 18, 2017.
- "GDELT Visual Knowledge Graph (VGKG) V1.0 Available". GDELT Blog. February 13, 2016. Retrieved October 18, 2017.
- "VGKG 2.0 Released - GDELT Blog". GDELT Blog. October 16, 2016. Retrieved October 18, 2017.
Finally, as the first GDELT 3.0 release, the VGKG 2.0 data stream updates every 60 seconds, allowing you near-realtime access to a codified view of global visual narratives.
- "GDELT 3.0 And Using BigQuery And Streaming Google Cloud Storage For Logging - GDELT Blog". GDELT Blog. March 24, 2017. Retrieved October 18, 2017.
- "GDELT GEO 2.0 API Debuts! - GDELT Blog". GDELT Blog. April 26, 2017. Retrieved October 18, 2017.
- "Google BigQuery". Retrieved October 17, 2017.
- "The GDELT event database data format codebook v2.0" (PDF). February 19, 2015. Retrieved October 17, 2017.
- "The GDELT Story: About the GDELT Project". Retrieved October 18, 2017.
- "GCAM Codebook". Retrieved October 17, 2017.