curl --request GET \
--url https://gdeltcloud.com/api/v2/intelligence/coverage \
--header 'Authorization: Bearer <token>'import requests
url = "https://gdeltcloud.com/api/v2/intelligence/coverage"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://gdeltcloud.com/api/v2/intelligence/coverage', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"as_of": "2026-08-22",
"window_days": 30,
"methodology_version": "atlas-pulse-1.2.0",
"floors": {
"pulse_events_per_day": 10,
"posture_events_per_window": 300,
"posture_events_per_30d": 300
},
"summary": {
"total_countries": 206,
"with_any_coverage": 198,
"depth": 143,
"supports_pulse": 151,
"supports_posture": 143
},
"countries": [
{
"iso3": "UKR",
"name": "Ukraine",
"region": "Eastern Europe",
"continent": "Europe",
"coverage_events_per_day": 72.7,
"coverage_events_window": 2180,
"days_observed": 30,
"days_clearing_pulse_floor": 30,
"supports": [
"pulse",
"posture"
],
"tier": "depth"
}
]
}Atlas coverage — where the index can and cannot be read
Per-country coded-event coverage over a trailing window, and therefore which country-level Atlas products (Pulse, Posture) each country is dense enough to serve today. Read it BEFORE treating a null Atlas reading as calm: below the floors means unknown, not quiet. All 206 countries are enumerated, so a country with no coverage is disclosed rather than omitted, and summary always describes the whole world even when the rows are filtered. The window is always trailing and always ends today — there is no historical or vintaged read here, which is why date, date_start, date_end and as_of are not parameters of this endpoint.
level is not a parameter of this endpoint. The Coverage Atlas is COUNTRY-grain by construction: it answers “which countries are dense enough to serve a country-level Pulse/Posture reading”, and its query is pinned to level = 'country'. There is no world/continent/region variant to select. For a different grain use /api/v2/intelligence/gpr, which does take level.
curl --request GET \
--url https://gdeltcloud.com/api/v2/intelligence/coverage \
--header 'Authorization: Bearer <token>'import requests
url = "https://gdeltcloud.com/api/v2/intelligence/coverage"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://gdeltcloud.com/api/v2/intelligence/coverage', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"as_of": "2026-08-22",
"window_days": 30,
"methodology_version": "atlas-pulse-1.2.0",
"floors": {
"pulse_events_per_day": 10,
"posture_events_per_window": 300,
"posture_events_per_30d": 300
},
"summary": {
"total_countries": 206,
"with_any_coverage": 198,
"depth": 143,
"supports_pulse": 151,
"supports_posture": 143
},
"countries": [
{
"iso3": "UKR",
"name": "Ukraine",
"region": "Eastern Europe",
"continent": "Europe",
"coverage_events_per_day": 72.7,
"coverage_events_window": 2180,
"days_observed": 30,
"days_clearing_pulse_floor": 30,
"supports": [
"pulse",
"posture"
],
"tier": "depth"
}
]
}Authorizations
Query Parameters
Return only countries in this coverage tier. depth = dense enough for a country-level Posture reading (the curated servable set); thin = some coverage but below that floor; none = no coded events in the window at all. Matched case-insensitively. Full value list: https://docs.gdeltcloud.com/reference/enums#atlas_coverage_tier
depth, thin, none Return only countries in this region, matched case-insensitively against the region name each row carries.
Middle East, Northern Africa, Western Africa, Eastern Africa, Middle Africa, Southern Africa, Eastern Europe, South Asia, Southeast Asia, East Asia, Central Asia, Northern America, Central America, Caribbean Response
Per-series coverage and floor status.
The response is of type object.

