curl --request GET \
--url https://gdeltcloud.com/api/v2/countries/{iso3} \
--header 'Authorization: Bearer <token>'import requests
url = "https://gdeltcloud.com/api/v2/countries/{iso3}"
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/countries/{iso3}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"data": {}
}Get country context
Country activity, dated economic/resource fundamentals, facilities and political-office inventories with evidence links. Unknown values remain null. Country association does not imply citizenship or headquarters. Counts of people, office-holder records, facilities and units are qualified separately.
curl --request GET \
--url https://gdeltcloud.com/api/v2/countries/{iso3} \
--header 'Authorization: Bearer <token>'import requests
url = "https://gdeltcloud.com/api/v2/countries/{iso3}"
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/countries/{iso3}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"data": {}
}Authorizations
GDELT Cloud API key. Send as Authorization: Bearer gdelt_sk_....
Path Parameters
The iso3.
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.
UTC hour selecting a publication bucket on one UTC date. Rejects hours that have not started. The current hour is allowed and describes publications so far; omit for the whole selected day. Requires date_start and date_end to be equal when both are sent. An hour selects one UTC date.
0 <= x <= 23publication 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. With basis=reporting: cannot be combined with hour. Reporting has day precision; select publication for hourly changes. Full value list: https://docs.gdeltcloud.com/reference/enums#country_basis
publication, reporting