Read country activity
Country publication aggregates and hourly evidence from the shared activity journal. Additions, updates and linked entities are separate metrics. Facility additions count published registry records (units), not newly built or deduplicated physical sites; country context inventories expose site and unit totals separately. All matching countries are included; this map is independent of evidence pagination. Source collection gaps remain explicit: unknown or withheld source counts are null in both country and hourly rows. meta.coverage.window_complete distinguishes an initialized journal from history covering the selected window; hourly_window_complete covers the entire timeline day. Actor-direction edges use Event occurrence dates, separately from publication activity. meta.edges_coverage exposes availability, status and oldest serving snapshot as_of; unavailable snapshots do not imply zero relationships.
Authorizations
GDELT Cloud API key. Send as Authorization: Bearer gdelt_sk_....
Query Parameters
Clock for date/hour filters and ordering: published preserves the serving/reference publication time; recorded uses the durable journal commit time and includes late publications when they become available. Omission retains published compatibility. Choose recorded explicitly for ongoing activity Monitors; source dates remain unchanged. Full value list: https://docs.gdeltcloud.com/reference/enums#activity-time-basis
published, recorded First UTC date in the selected time_basis. Defaults to today; future dates are rejected. Neither clock is Event occurrence time. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.
Last UTC date in the selected time_basis, inclusive. Defaults to date_start and cannot be later than the current UTC day. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.
Optional UTC hour, 0–23. Requires a single date and rejects hours that have not started. The current hour is allowed and describes publications so far; omit for the whole selected day.
0 <= x <= 23Known country attribution. Evidence distinguishes location, actor origin, reporting and source association. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply. Full value list: https://docs.gdeltcloud.com/reference/enums#country
publication retains the activity journal clock. reporting uses distinct served Events by occurrence date and location country (country_match=location), and Stories by reporting date under every authoritative country association (the Stories summary country_attribution=all mode). Country buckets may overlap for Stories; totals are computed independently. Reporting has day precision and rejects hour. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.
Include Event metric maxima with tied-country evidence, five AI-coded metric averages with scored Event counts, and per-country readings/linked identity counts. Reporting basis only; occurrence-date and location scope. Averages weight each finite scored canonical Event equally, independently of directory pagination. Unrestricted world averages include unlocated Events; geographic filters use location. Goldstein remains a signed maximum only. No scored observations gives null/count 0; unavailable context remains null.
Include dated macro rollups for the selected geography, with same-period coverage and aggregation methods. Requires intelligence entitlement.
Enumerate every registered country, including countries without observed activity; supports search, geography, sort and pagination.
Country directory name or ISO code search. Requires directory=true.
Registered region scope. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply. Full value list: https://docs.gdeltcloud.com/reference/enums#region
Africa, Asia, Middle East, Northern Africa, Western Africa, Eastern Africa, Middle Africa, Southern Africa, Europe, Eastern Europe, South Asia, Southeast Asia, East Asia, Central Asia, North America, Central America, Caribbean, South America, Oceania Registered continent scope. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply. Full value list: https://docs.gdeltcloud.com/reference/enums#continent
Africa, Asia, Europe, North America, South America, Oceania Directory order: name alphabetically (default in directory mode), events or stories descending with stable name ties. Requires directory=true. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.
Countries per directory page (default 25 in directory mode). Requires directory=true; otherwise this parameter is rejected. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.
1 <= x <= 250Directory row offset (default 0 in directory mode). Requires directory=true.
x >= 0Response
Success
true Maximum signed Event metrics by occurrence date, with evidence from every tied country.
Five AI-coded metric means weighted by scored Event observations, never country means or maxima. Independent of directory pagination. World scope includes unlocated Events; geographic filters use Event location. Null when context is unavailable or not requested.