Développeurs
API de données ouvertes
JSON en lecture seule sur l'ensemble du site. Ni clé, ni compte, ni traçage. Soyez raisonnable avec le volume de requêtes — c'est un petit serveur.
| Point final | Retours |
|---|---|
/api/v1/materials | Chaque matériau avec son étagère, son indicateur de criticité, la production mondiale et les réserves. |
/api/v1/material/{slug} | Une matière en intégralité : faits, minéraux, production et réserves par pays, mines, usines, entreprises, marchés finaux et intensités. |
/api/v1/production?material={slug}&series= | Production mondiale par pays pour UNE série publiée. Lorsqu'un matériau en comporte plusieurs — le cuivre dispose d'une série pour la production minière et d'une autre pour la production des raffineries — meta.all_series les répertorie et elles ne doivent jamais être additionnées. |
/api/v1/reserves?material={slug}&series= | Réserves mondiales par pays pour une série. Le chrome, par exemple, est publié à la fois en teneur en Cr2O3 et en minerai. |
/api/v1/mines | Mines et gisements nommés avec opérateur, type, statut, localisation et matières. |
/api/v1/facilities | Usines de traitement, d'affinage et de fabrication, avec stade, type et matériaux. |
/api/v1/companies | Entreprises avec rôle, pays, matériaux et — le cas échéant — une cotation différée. |
/api/v1/countries | Pays avec leur nombre de matériaux et d'actifs. |
/api/v1/chains | Chaînes d'approvisionnement avec chaque étape et le nœud vers lequel elle pointe. |
/api/v1/journeys?material={slug}&origin={ISO2} | Trajets de custody : un itinéraire précis par ligne, avec chaque étape, dépositaire, franchissement de frontière et le bilan massique à chaque stade. |
/api/v1/journey/{slug} | Un trajet complet, avec les variantes qu'il aurait pu emprunter. |
/api/v1/technologies | Technologies avec leurs intensités matérielles indicatives et leurs bases. |
/api/v1/glossary | Chaque terme du glossaire, définitions simples et techniques. |
/api/v1/search?term= | Rechercher parmi les matériaux, les mines, les usines, les entreprises, les pays et les termes. |
Conventions
- Chaque réponse contient un bloc « source » indiquant le jeu de données et l'édition.
- Les champs numériques sont nuls lorsque la source n'a publié aucun chiffre ; un champ « code » porte alors W, XX, NA ou un tiret, et une « note » précise lequel. Nul ne signifie jamais zéro.
- Chaque ligne indique la série à laquelle elle appartient. Deux séries portant sur le même matériau mesurent des choses différentes et ne doivent pas être additionnées.
- Les unités sont par ligne, non par point de données — les matières premières sont déclarées sur des bases différentes.
- Les années indiquées sont les années de référence de la source, non la date à laquelle nous avons récupéré les données.
Les données USGS sous-jacentes sont dans le domaine public ; utilisez-les depuis la source et citez-les. Notre compilation nous appartient — un lien en retour est apprécié. Rien de ce qui est fourni ici ne constitue un conseil en investissement.