Developers
Open data API
Read-only JSON over everything in the atlas. No key, no account, no tracking. Be reasonable with request volume — it is a small server.
| Endpoint | Returns |
|---|---|
/api/v1/materials | Every material with its shelf, criticality flag, world production and reserves. |
/api/v1/material/{slug} | One material in full: facts, minerals, production and reserves by country, mines, plants, companies, end markets and intensities. |
/api/v1/production?material={slug}&series= | World production by country for ONE published series. Where a material has more than one — copper has mine production and refinery production — meta.all_series lists them and they must never be added. |
/api/v1/reserves?material={slug}&series= | World reserves by country for one series. Chromium, for example, is published both as Cr2O3 content and as ore. |
/api/v1/mines | Named mines and deposits with operator, type, status, location and materials. |
/api/v1/facilities | Processing, refining and manufacturing plants with stage, kind and materials. |
/api/v1/companies | Companies with role, country, materials and — where carried — a delayed quote. |
/api/v1/countries | Countries with their material counts and asset counts. |
/api/v1/chains | Supply chains with every stage and the node each stage points at. |
/api/v1/journeys?material={slug}&origin={ISO2} | Custody journeys: one specific route per row, with every step, custodian, border crossing and the mass balance at each stage. |
/api/v1/journey/{slug} | One journey in full, including the alternatives it could have taken. |
/api/v1/technologies | Technologies with their indicative material intensities and bases. |
/api/v1/glossary | Every glossary term, plain and technical definitions. |
/api/v1/search?term= | Search across materials, mines, plants, companies, countries and terms. |
Conventions
- Every response carries a "source" block naming the dataset and the edition.
- Numeric fields are null when the source published no number; a "code" field then carries W, XX, NA or a dash, and a "note" explains which. Null never means zero.
- Every row carries the series it belongs to. Two series of the same material measure different things and must not be summed.
- Units are per row, not per endpoint — commodities are reported on different bases.
- Years are the source’s reference years, not the date we fetched the data.
The underlying USGS data is public domain; use it from the source and cite it. Our compilation is ours — a link back is appreciated. Nothing served here is investment advice.