Ontwikkelaars
Open data-API
Alleen-lezen JSON over alles in de atlas. Geen sleutel, geen account, geen tracking. Wees redelijk met het aanvraagvolume — het is een kleine server.
| Eindpunt | Rendementen |
|---|---|
/api/v1/materials | Elk materiaal met zijn categorie, kritiekheidsmarkering, wereldproductie en reserves. |
/api/v1/material/{slug} | Één grondstof volledig: feiten, mineralen, productie en reserves per land, mijnen, installaties, bedrijven, eindmarkten en intensiteiten. |
/api/v1/production?material={slug}&series= | Wereldproductie per land voor ÉÉN gepubliceerde reeks. Waar een materiaal er meer dan één heeft — koper heeft mijnproductie en raffinageproductie — worden ze vermeld in meta.all_series en mogen ze nooit worden opgeteld. |
/api/v1/reserves?material={slug}&series= | Wereldreserves per land voor één reeks. Chroom bijvoorbeeld wordt zowel gepubliceerd als Cr2O3-gehalte als als erts. |
/api/v1/mines | Benoemde mijnen en afzettingen met exploitant, type, status, locatie en materialen. |
/api/v1/facilities | Verwerkings-, raffineer- en productiebedrijven met fase, type en materialen. |
/api/v1/companies | Bedrijven met rol, land, materialen en — waar beschikbaar — een vertraagde koers. |
/api/v1/countries | Landen met hun aantallen materialen en activa. |
/api/v1/chains | Toeleveringsketens met elke fase en het knooppunt waarnaar elke fase verwijst. |
/api/v1/journeys?material={slug}&origin={ISO2} | Bewaarketens: één specifieke route per rij, met elke stap, bewaarder, grensovergang en de massabalans in elke fase. |
/api/v1/journey/{slug} | Eén volledige reis, inclusief de alternatieven die mogelijk waren geweest. |
/api/v1/technologies | Technologieën met hun indicatieve materiaalintensiteiten en grondslagen. |
/api/v1/glossary | Alle glossariumtermen, eenvoudige en technische definities. |
/api/v1/search?term= | Zoek door materialen, mijnen, installaties, bedrijven, landen en termen. |
Conventies
- Elk antwoord bevat een "source"-blok met de naam van de dataset en de editie.
- Numerieke velden zijn leeg wanneer de bron geen getal heeft gepubliceerd; een 'code'-veld bevat dan W, XX, NA of een streepje, en een 'note' legt uit welke. Leeg betekent nooit nul.
- Elke rij bevat de reeks waartoe hij behoort. Twee reeksen van hetzelfde materiaal meten verschillende dingen en mogen nooit worden opgeteld.
- Eenheden gelden per rij, niet per eindpunt — grondstoffen worden op verschillende grondslagen gerapporteerd.
- De jaren zijn de referentiejaren van de bron, niet de datum waarop wij de gegevens hebben opgehaald.
De onderliggende USGS-data zijn publiek domein; gebruik ze via de bron en citeer ze. Onze compilatie is van ons — een terugkoppeling wordt op prijs gesteld. Niets op deze site is beleggingsadvies.