Ranking de países produtores e detentores de reservas de um mineral

Responde 'quem produz mais' e 'quem tem as maiores reservas': ranking de países produtores com a participação no total mundial, para lítio, cobre, nióbio, cobalto, terras raras, grafita, ferro, ouro, fosfato, potássio e as demais commodities do catálogo. Use `statistic=production` para produção do ano e `statistic=reserves` para reservas. É a rota certa para perguntas como 'quanto do nióbio do mundo vem do Brasil', 'quem domina a produção de terras raras' ou 'quais países concentram as reservas de lítio'. Como ler o resultado sem errar: - `share_of_world_pct` é NULO quando a participação não pode ser calculada, e `share_basis` diz o motivo. Nunca trate ausência como zero. O motivo mais sutil é `incomparable_basis`: existe total mundial, mas os países reportam bases diferentes, como nas reservas de boro, em que a Turquia declara boratos refinados, o Chile ulexita e a China óxido bórico equivalente. Não são somáveis, e é por isso que o próprio USGS marca o total como `XX`. - `meta.countries_withheld` acima de zero significa ranking INCOMPLETO: o USGS reteve o valor de países onde ele revelaria dado proprietário de empresa, então os shares não somam 100%. - `meta.is_estimate` verdadeiro significa que o ano é estimativa do USGS, não realizado. - Quando a commodity tem mais de um agregado (cobre tem produção de mina e produção de refino, com totais mundiais distintos), o ranking usa um recorte só e informa os outros em `meta.available_details`; troque com `?detail=`. - Em `statistic=reserves` o número é ESTIMATIVA GEOLÓGICA AGREGADA POR PAÍS publicada pelo USGS. Não é reserva provada ou provável declarada por companhia sob SEC S-K 1300, JORC ou NI 43-101, não tem a mesma auditoria e não deve ser comparada com o relatório técnico de uma mineradora.

curl -X GET "https://api.databolsa.com/v1/minerals/string/producers?statistic=production&year=1900&detail=string"

{
  "data": [
    {
      "rank": 0,
      "country": "string",
      "country_iso3": "string",
      "country_label": "string",
      "is_aggregate": true,
      "value": 0,
      "value_raw": "string",
      "value_flag": "string",
      "value_flag_reason": "string",
      "unit": "string",
      "share_of_world_pct": 0,
      "share_basis": "string",
      "statistic_detail": "string",
      "statistic_detail_base": "string",
      "is_estimate": true,
      "notes": "string"
    }
  ],
  "meta": {
    "next_cursor": "string",
    "count": 0,
    "total": 0,
    "subject": {
      "property1": "string",
      "property2": "string"
    },
    "mineral": "string",
    "label": "string",
    "statistic": "string",
    "year": 0,
    "detail": "string",
    "available_details": [
      {
        "detail": "string",
        "countries": 0,
        "unit": "string",
        "world_total": 0,
        "world_total_flag": "string"
      }
    ],
    "unit": "string",
    "world_total": 0,
    "world_total_flag": "string",
    "countries_withheld": 0,
    "is_estimate": true,
    "is_critical": true,
    "edition": "string",
    "edition_year": 0
  }
}

{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string"
}