GET /v1/overview | API REST de NowMetrix

Solicitud

GET https://api.nowmetrix.com/v1/overview?site=TRACKER_ID&days=7

Esta es la ruta compacta para informes de tendencias, importaciones en herramientas de BI, exportaciones a hojas de cálculo y resúmenes semanales o mensuales sencillos.

Autenticación

Se requiere una clave de API en la cabecera Authorization, con el valor Authorization: Bearer nm_YOUR_KEY.

Parámetros de consulta

Nombre	Tipo	Obligatorio	Descripción
`site`	`string`	obligatorio	Identificador del tracker. La clave de API debe tener acceso a este tracker.
`days`	`integer`	opcional	Número de días que se devolverán. El valor se limita al intervalo 1-30. Valor predeterminado: 30.

Ejemplo de cURL

curl -H "Authorization: Bearer nm_YOUR_KEY" \
  "https://api.nowmetrix.com/v1/overview?site=TRACKER_ID&days=7"

Ejemplo de respuesta

{
  "site": "TRACKER_ID",
  "timezone": "Europe/Zurich",
  "range": {
    "from": "2026-06-20",
    "to": "2026-06-26",
    "days": 7
  },
  "daily": [
    {
      "date": "2026-06-20",
      "pageviews": 81240,
      "visits": 53210
    },
    {
      "date": "2026-06-21",
      "pageviews": 77480,
      "visits": 50195
    },
    {
      "date": "2026-06-22",
      "pageviews": 48215,
      "visits": 31890
    }
  ],
  "totals": {
    "pageviews": 206935,
    "visits": 135295
  }
}

Campos de respuesta

Campo	Tipo	Descripción
`site`	`string`	Identificador del tracker utilizado para la solicitud.
`timezone`	`string`	Zona horaria del tracker utilizada para determinar las fechas locales.
`range.from`	`string`	Primera fecha del array diario devuelto.
`range.to`	`string`	Última fecha del array diario devuelto.
`range.days`	`integer`	Número de filas diarias devueltas.
`daily[]`	`array<object>`	Filas diarias ordenadas por fecha ascendente.
`daily[].date`	`string`	Fecha en formato YYYY-MM-DD.
`daily[].pageviews`	`integer`	Páginas vistas correspondientes a la fecha.
`daily[].visits`	`integer`	Visitas correspondientes a la fecha.
`totals.pageviews`	`integer`	Suma de las páginas vistas de las filas diarias devueltas.
`totals.visits`	`integer`	Suma de las visitas de las filas diarias devueltas.

Actualización y caché

Las respuestas se almacenan en una microcaché durante 60 segundos para cada tracker y valor de days, con un breve periodo de tolerancia para datos obsoletos como protección frente a picos de solicitudes.

Errores

HTTP	Código	Descripción
400	`site_required`	Falta el parámetro site obligatorio.
401	`missing_token`	Falta la cabecera Authorization.
401	`invalid_token`	El token no es válido o se ha revocado.
403	`site_not_authorized`	La clave de API no tiene acceso a este tracker.
429	`rate_limit_exceeded`	Se ha superado el límite de solicitudes.
503	`redis_unavailable`	El backend en tiempo real no está disponible temporalmente.

{
  "error": {
    "code": "invalid_token",
    "message": "Bearer token is invalid or revoked."
  }
}