curl --request GET \
--url https://gdeltcloud.com/api/v2/resources/statistics \
--header 'Authorization: Bearer <token>'import requests
url = "https://gdeltcloud.com/api/v2/resources/statistics"
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/resources/statistics', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"data": []
}Natural-resource statistics
USGS country and aggregate production, reserves and qualified statistics. Values preserve unknown, suppressed, qualitative and bounded observations. Country totals are independent of the Facilities inventory. Country/region/continent filters select country-scope rows only; use include_summary for full-filtered count facets, never summed values.
curl --request GET \
--url https://gdeltcloud.com/api/v2/resources/statistics \
--header 'Authorization: Bearer <token>'import requests
url = "https://gdeltcloud.com/api/v2/resources/statistics"
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/resources/statistics', 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_....
Query Parameters
Number of records to return on this page; use the returned continuation to request the next page. 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 <= 200Continuation from pagination.next_cursor in the previous response. Keep the other filters unchanged; null means no next page. Also accepts: offset. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.
Contributing publisher/source identifier from the returned records or source catalog. Matched case-insensitively. Full value list: https://docs.gdeltcloud.com/reference/enums#resource_statistic_source
usgs_mcs, usgs_myb Country name, ISO-2 or ISO-3; comma-separated inputs are allowed. Geography filters select country-scoped rows only.
Country name or ISO country code for country-scoped source observations; comma-separated countries are combined as alternatives.
Geographic region whose member countries define the scope. Matched case-insensitively. 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 Continent whose member countries define the geographic scope. Matched case-insensitively. 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 Exact normalized commodity key; observed suggestions are open and not an allowlist. Aggregate rare-earth oxides differ from individual elements. Matched case-insensitively. Observed vocabulary, measured 2026-10-03 (160 distinct values). Values outside it are accepted, not rejected. Discover current values: GET /api/v2/meta/enums (resource_commodity) or inspect resource-statistics results. Values seen in the corpus: https://docs.gdeltcloud.com/reference/enums#resource_commodity
Exact source statistic name; observed suggestions are open and not an allowlist. Matched case-insensitively. Observed vocabulary, measured 2026-10-03 (16 distinct values). Values outside it are accepted, not rejected. Discover current values: GET /api/v2/meta/enums (resource_statistic) or inspect resource-statistics results. Values seen in the corpus: https://docs.gdeltcloud.com/reference/enums#resource_statistic
Native source qualifier for a statistic; use the returned statistic_detail to distinguish observations with the same statistic name.
Source-reported kind of material represented by the statistic; copy the returned material_type when narrowing observations.
Source-reported form of the material, such as an ore or refined product; copy the returned material_form.
country, aggregate or unresolved source scope. Matched case-insensitively. Full value list: https://docs.gdeltcloud.com/reference/enums#resource_statistic_scope
country, aggregate, unresolved Source reference year.
1900 <= x <= 2100Include count-only aggregates for the full filtered result before pagination. Values are never summed across sources, years or units.