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

Rows per page. Default 25, max 200. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.

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

Opaque pagination cursor taken from the previous response's pagination.next_cursor. 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.

source
string

Source identifier; usgs_mcs or usgs_myb.

country
string

Exact ISO-3 country; aggregate observations have their own scope.

commodity
string

Exact normalized commodity key. Aggregate rare-earth oxides differ from individual elements.

statistic
string

Exact source statistic name, case-insensitive.

scope
string

country, aggregate or unresolved.

year
integer

Source reference year.

Required range: 1900 <= x <= 2100

Response

Success

success
boolean
data
object[]