API with GDELT data at the regional level

Did you know that you can use an API to display instability scores computed from GDELT data?

Below, an example for the French region (first administrative level):

https://api.gdeltproject.org/api/v1/dash_stabilitytimeline/dash_stabilitytimeline?LOC=FR&VAR=instability&OUTPUT=viz&TIMERES=day&MODE=multi&SMOOTH=0

which produces the following result:

Changing the option OUTPUT=viz by OUTPUT=csv produces a CSV file:

You can try for Brazilian regions by changing LOC=FR by LOC=BR and paste the result in your search bar:

Before closing this blog, let me add that the country codes are available here:  files for country codes and ADM1 codes.

More information on GDELT data can be found in a previous post: