world-mineral-statistics

Get BGS World Mineral Statistics items

Welcome to the World Mineral Statistics archive API. The British Geological Survey (BGS) and its predecessor organisations have compiled production and trade statistics on a wide range of mineral commodities since 1913. Currently this tool permits access to data from the World Mineral Statistics archive for the years 1970 to 2022. Prior to 1970 the data are available in PDF files which you can download for free from the main archive page. Selected data from 1960 are also available from the main archive as a static table in MS Excel. For certain commodities data are not available for all years, for example the BGS commenced collation of data for primary aggregates in 1998 and consequently there are no data for earlier years for this particular commodity. Trade data (imports and exports) are available for all countries up to 2002, and for selected European countries only from 2003 to 2018. Please ensure that you have read and understand our terms and conditions for the data.

get/collections/world-mineral-statistics/items

Query parameters

f'json' | 'html' | 'jsonld' | 'csv'

The optional f parameter indicates the output format which the server shall provide as part of the response document. The default format is GeoJSON.

lang'en-US'

The optional lang parameter instructs the server return a response in a certain language, if supported. If the language is not among the available values, the Accept-Language header language will be used if it is supported. If the header is missing, the default server language is used. Note that providers may only support a single language (or often no language at all), that can be different from the server language. Language strings can be written in a complex (e.g. "fr-CA,fr;q=0.9,en-US;q=0.8,en;q=0.7"), simple (e.g. "de") or locale-like (e.g. "de-CH" or "fr_BE") fashion.

bboxnumber[]

Only features that have a geometry that intersects the bounding box are selected.The bounding box is provided as four or six numbers, depending on whether the coordinate reference system includes a vertical axis (height or depth).

limitinteger

The optional limit parameter limits the number of items that are presented in the response document (maximum=1000000, default=10).

crsstring uri

Indicates the coordinate reference system for the results.

bbox-crsstring uri

Indicates the coordinate reference system for the given bbox coordinates.

propertiesstring[]

The properties that should be included. The parameter value is a comma-separated list of property names.

vendorSpecificParametersobject

Additional "free-form" parameters that are not explicitly defined

skipGeometryboolean

This option can be used to skip response geometries for each feature.

offsetinteger

The optional offset parameter indicates the index within the result set from which the server shall begin presenting results in the response document. The first element has an index of 0 (default).

synthetic_idstring
yearstring date-time
yearbook_table_idinteger
yearbook_table_transstring
bgs_statistic_type_transstring
country_transstring
country_iso2_codestring
country_iso3_codestring
pole_of_inaccessibility_longitudenumber
pole_of_inaccessibility_latitudenumber
bgs_commodity_codeinteger
bgs_commodity_transstring
bgs_sub_commodity_transstring
erml_groupstring
erml_commoditystring
erml_sub_commoditystring
cgi_commodity_urlstring
quantitynumber
quantity_in_book_stylestring
data_precision_descriptionstring
sdmx_codestring
sdmx_translationstring
unitsstring
concat_table_notes_codestring
concat_table_notes_textstring
concat_figure_notes_codestring
concat_figure_notes_textstring

Parameters

https://raw.githubusercontent.com/opengeospatial/ogcapi-records/master/core/openapi/parameters/sortby.yaml — unresolved $ref

Response

— unresolved $ref