Analíticas

Obtiene estadisticas de uso agregadas para tu cuenta — subidas a lo largo del tiempo, crecimiento de almacenamiento, desglose por tipo de archivo y ancho de banda del gateway. Filtrable por rango de tiempo y clave API.

Obtener Analíticas

GET /analytics

Parámetro	Tipo	Requerido	Descripción
from	number	Sí	Marca de tiempo de inicio en milisegundos unix.
to	number	Sí	Marca de tiempo de fin en milisegundos unix.
apiKey	string	No	Filtrar por prefijo de clave API (ej. "bws_0a3ff5f7") o prefijo de token firmado (ej. "sup_a1b2c3d4"). Solo muestra subidas realizadas con esa clave o token.

Ejemplo de solicitud

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

Respuesta 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 refleja el uso del mes actual independientemente del rango from/to. El filtro apiKey solo se aplica a las metricas de subida — el ancho de banda del gateway es a nivel de cuenta. Los prefijos de tokens de subida firmados se almacenan en el mismo campo que los prefijos de claves API, por lo que puedes filtrar por prefijo de token firmado (ej. sup_a1b2c3d4) para ver las subidas realizadas con un token firmado específico.