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
GDELT Cloud API key. Send as Authorization: Bearer gdelt_sk_....
Query Parameters
Coverage measurement window in days (1–30).
1 <= x <= 30Return 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. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.
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 Return only countries on this continent, matched case-insensitively against the continent name each row carries. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.
Africa, Asia, Europe, North America, South America, Oceania Response
Per-series coverage and floor status.
The response is of type object.