Desarrolladores
API de datos abiertos
JSON de solo lectura sobre todo el contenido del atlas. Sin clave, sin cuenta, sin rastreo. Sea razonable con el volumen de solicitudes: es un servidor pequeño.
| Punto final | Retornos |
|---|---|
/api/v1/materials | Todos los materiales con su categoría, indicador de criticidad, producción mundial y reservas. |
/api/v1/material/{slug} | Un material en profundidad: datos, minerales, producción y reservas por país, minas, plantas, empresas, mercados finales e intensidades. |
/api/v1/production?material={slug}&series= | Producción mundial por país para UNA serie publicada. Cuando un material tiene más de una — el cobre tiene producción minera y producción de refinería — meta.all_series las enumera y no deben sumarse nunca. |
/api/v1/reserves?material={slug}&series= | Reservas mundiales por país para una serie. El cromo, por ejemplo, se publica tanto como contenido de Cr2O3 como en forma de mineral. |
/api/v1/mines | Minas y yacimientos identificados, con operador, tipo, estado, ubicación y materiales. |
/api/v1/facilities | Plantas de procesamiento, refinación y fabricación con etapa, tipo y materiales. |
/api/v1/companies | Empresas con su función, país, materiales y — cuando estén disponibles — una cotización diferida. |
/api/v1/countries | Países con sus recuentos de materiales y de activos. |
/api/v1/chains | Cadenas de suministro con cada etapa y el nodo al que apunta cada etapa. |
/api/v1/journeys?material={slug}&origin={ISO2} | Trayectorias de custodia: una ruta específica por fila, con cada etapa, custodio, cruce fronterizo y el balance de masa en cada paso. |
/api/v1/journey/{slug} | Un recorrido completo, incluidas las alternativas que podría haber tomado. |
/api/v1/technologies | Tecnologías con sus intensidades de material orientativas y bases. |
/api/v1/glossary | Todos los términos del glosario, definiciones simples y técnicas. |
/api/v1/search?term= | Busque entre materiales, minas, plantas, empresas, países y términos. |
Convenciones
- Cada respuesta incluye un bloque de "fuente" que nombra el conjunto de datos y la edición.
- Los campos numéricos son nulos cuando la fuente no publicó ningún valor; un campo «code» lleva entonces W, XX, NA o un guion, y un campo «note» explica cuál. Nulo nunca significa cero.
- Cada fila lleva la serie a la que pertenece. Dos series del mismo material miden cosas distintas y no deben sumarse.
- Las unidades son por fila, no por extremo: los productos básicos se reportan en bases distintas.
- Los años corresponden a los años de referencia de la fuente, no a la fecha en que obtuvimos los datos.
Los datos subyacentes del USGS son de dominio público; úselos desde la fuente y cítela. Nuestra compilación es nuestra — se agradece un enlace de vuelta. Nada de lo que se sirve aquí constituye asesoramiento de inversión.