Skip to main content
GET
Natural-resource statistics

Authorizations

Authorization
string
header
required

GDELT Cloud API key. Send as Authorization: Bearer gdelt_sk_....

Query Parameters

limit
integer
default:25

Number of records to return on this page; use the returned continuation to request the next page.

Required range: 1 <= x <= 200
cursor
string

Continuation from pagination.next_cursor in the previous response. Keep the other filters unchanged; null means no next page.

source
enum<string>

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

Available options:
usgs_mcs,
usgs_myb
country
string

Country name, ISO-2 or ISO-3; comma-separated inputs are allowed. Geography filters select country-scoped rows only.

country_iso3
string

Country name or ISO country code for country-scoped source observations; comma-separated countries are combined as alternatives.

region
enum<string>

Geographic region whose member countries define the scope. Matched case-insensitively. Full value list: https://docs.gdeltcloud.com/reference/enums#region

Available options:
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
continent
enum<string>

Continent whose member countries define the geographic scope. Matched case-insensitively. Full value list: https://docs.gdeltcloud.com/reference/enums#continent

Available options:
Africa,
Asia,
Europe,
North America,
South America,
Oceania
commodity
string

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

statistic
string

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

statistic_detail
string

Native source qualifier for a statistic; use the returned statistic_detail to distinguish observations with the same statistic name.

material_type
string

Source-reported kind of material represented by the statistic; copy the returned material_type when narrowing observations.

material_form
string

Source-reported form of the material, such as an ore or refined product; copy the returned material_form.

scope
enum<string>

country, aggregate or unresolved source scope. Matched case-insensitively. Full value list: https://docs.gdeltcloud.com/reference/enums#resource_statistic_scope

Available options:
country,
aggregate,
unresolved
year
integer

Source reference year.

Required range: 1900 <= x <= 2100
include_summary
boolean
default:false

Include count-only aggregates for the full filtered result before pagination. Values are never summed across sources, years or units.

Response

Success

success
enum<boolean>
required
Available options:
true
data
object[]
required
meta
object
required
pagination
object
required
applied_filters
object
required