Analíticas

Obtenha estatísticas de uso agregadas da sua conta — uploads ao longo do tempo, crescimento de armazenamento, detalhamento por tipo de arquivo e largura de banda do gateway. Filtravel por intervalo de tempo e chave API.

Obter Analíticas

GET /analytics

Parâmetro	Tipo	Obrigatório	Descrição
from	number	Sim	Timestamp de inicio em milissegundos unix.
to	number	Sim	Timestamp de fim em milissegundos unix.
apiKey	string	Não	Filtrar por prefixo de chave API (ex.: "bws_0a3ff5f7") ou prefixo de token assinado (ex.: "sup_a1b2c3d4"). Mostra apenas uploads feitos com essa chave ou token.

Exemplo de requisição

curl "https://api.ipfs.ninja/analytics?from=1711036800000&to=1711641600000" \
  -H "X-Api-Key: bws_your_api_key_here"

Resposta 200 OK

{
  "period": { "from": 1711036800000, "to": 1711641600000 },
  "totals": {
    "uploads": 42,
    "storageMB": 15.3,
    "fileTypes": { "json": 25, "image": 12, "pdf": 5 }
  },
  "daily": [
    { "date": "2026-03-21", "uploads": 20, "sizeMB": 8.1 },
    { "date": "2026-03-22", "uploads": 22, "sizeMB": 7.2 }
  ],
  "storageGrowth": [
    { "date": "2026-03-21", "cumulativeMB": 8.1 },
    { "date": "2026-03-22", "cumulativeMB": 15.3 }
  ],
  "gatewayBandwidthMB": 1200,
  "gatewayBandwidthLimitMB": 51200
}

TIP

gatewayBandwidthMB reflete o uso do mes atual independentemente do intervalo from/to. O filtro apiKey se aplica apenas as metricas de upload — a largura de banda do gateway e de toda a conta. Os prefixos de tokens de upload assinados são armazenados no mesmo campo que os prefixos de chaves API, entao você pode filtrar por prefixo de token assinado (ex.: sup_a1b2c3d4) para ver os uploads feitos com um token assinado específico.