By Jan Tschada | Updated 3 months ago | Mapping

geoprotests Overview


The service filters thousands of online news sources of the last 24 hours mentioning occurred protests or demonstrations. We are using a web mercator projection using a grid size being optimized for geographic visualization. Each grid cell has a count attribute representing the number of news article related to locations of the corresponding grid cell.

The service uses the impressive data source provided by the Global Database of Events, Language and Tone (GDELT) Project (

This API aggregates locations where some kind of protest took place using geospatial intelligence operations. The geospatial results support the GeoJSON and Esri Features format out of the box.

Ready to use
The geoprotests API offer ready-to-use geospatial features representing broadcasted news related to protests and demonstrations. You can use these geospatial features to build various mapping and geospatial applications. The underlying serverless cloud-backend analyses raw geospatial locations of news articles provided by the Global Database of Events, Language and Tone (GDELT) Project (

Every geospatial result support the GeoJSON and Esri FeatureSet format out of the box. All endpoints support an optional date parameter for filtering the results. For best performance, the serverless cloud-backend calculate the geospatial aggregations of the last 24 hours between midnight and 1 AM UTC. The serverless functions save these geospatial features for the last 90 days and yesterday should be the latest available date. Without specifying a date, we have to calculate the geospatial features of the last 24 hours on-the-fly.


Aggregate broadcasted news
Aggregates the broadcasted news related to protests/demonstrations using a spatial grid and returns the features as hexagonal bins. These features represent the coarse grained geographically view of the broadcasted news.

Query source articles
Returns a list of broadcasted articles related to protests/demonstrations. The extracted locations of these news articles define the source for the calculation of the geospatial aggregations.

Query named hotspot locations
Returns the hotspot location features related to protests/demonstrations. A hotspot location feature represents the extracted and geocoded named location occured in many news articles.

Specific Python client libraries

  • geoint-py
    A bunch of geospatial intelligence workflows implemented using Python.
Followers: 2
Product Website Terms of use
API Creator:
Rapid account: Jan Tschada
Jan Tschada
Log In to Rate API
Rating: 5 - Votes: 1