GET /v1/recap

Utilice Recap cuando la integración necesite consultar datos anteriores: informes históricos, exportaciones de páginas principales, rangos de fechas personalizados o resultados filtrados mediante búsqueda.

Requiere una clave de API en la cabecera Authorization: Bearer nm_YOUR_KEY.

curl -H "Authorization: Bearer nm_YOUR_KEY" \
  "https://api.nowmetrix.com/v1/recap?site=TRACKER_ID&preset=last30&limit=25"

{
  "site": "TRACKER_ID",
  "preset": "last30",
  "timezone": "Europe/Zurich",
  "range": {
    "from": "2026-05-28",
    "to": "2026-06-26",
    "label": "Last 30 Days",
    "days": 30
  },
  "limits": {
    "min_date": "2025-03-17",
    "max_date": "2026-06-26",
    "max_days": null
  },
  "search": {
    "query": ""
  },
  "daily": [
    {
      "date": "2026-06-25",
      "pageviews": 102400,
      "visits": 12800
    },
    {
      "date": "2026-06-26",
      "pageviews": 98450,
      "visits": 12130
    }
  ],
  "summary": {
    "total_pageviews": 3158127,
    "total_visits": 388450,
    "pages_per_visitor": 8.1
  },
  "top_pages": [
    {
      "rank": 1,
      "title": "Home page",
      "author": "",
      "pubdate": "",
      "url": "/",
      "url_full": "https://example-media.test/",
      "url_id": "5dc0a5883395e2a126e5239650d9268e",
      "thumbnail": "https://realtimemetadata.fra1.cdn.digitaloceanspaces.com/thumbnails/example.jpg",
      "pageviews": 159280
    },
    {
      "rank": 2,
      "title": "Culture desk live notes",
      "author": "Alex Morgan",
      "pubdate": "2026-06-24",
      "url": "/culture/live-notes",
      "url_full": "https://example-media.test/culture/live-notes",
      "url_id": "b35c1a5f2fd0cbb7f3c13b853c2a9d2c",
      "thumbnail": "https://realtimemetadata.fra1.cdn.digitaloceanspaces.com/thumbnails/example-2.jpg",
      "pageviews": 85632
    }
  ],
  "generated_at": "2026-06-26T12:30:00Z"
}

Añada offset=0 para activar la paginación. Cada respuesta contiene como máximo 100 artículos; la instantánea contiene como máximo 2000. Sin offset ni snapshot, el formato de respuesta y el límite existentes no cambian.

Para cada página siguiente, envíe pagination.next_offset como offset y pagination.snapshot_id como snapshot. Repita los parámetros originales site, preset, start, end y search, incluidas las fechas personalizadas. Deténgase cuando next_offset sea null. Un offset igual o superior al número disponible devuelve una matriz top_pages vacía.

El orden de los artículos, las páginas vistas, los valores diarios, el resumen y generated_at permanecen fijos entre páginas, incluso en rangos que incluyen el día actual. Las métricas de resumen abarcan todo el rango seleccionado; pagination.total solo cuenta los artículos de la instantánea limitada. Todas las solicitudes siguen requiriendo una autorización válida y cuentan para el límite de solicitudes del tracker.

Las instantáneas caducan después de 10 minutos. La lectura de las páginas no prolonga ese plazo. En HTTP 410, descarte el recorrido parcial y reinícielo con offset=0 sin snapshot. Los ejemplos siguientes muestran la primera solicitud, una continuación y el objeto de paginación adicional.

GET https://api.nowmetrix.com/v1/recap?site=TRACKER_ID&preset=last30&limit=100&offset=0
GET https://api.nowmetrix.com/v1/recap?site=TRACKER_ID&preset=last30&limit=100&offset=100&snapshot=0123456789abcdef0123456789abcdef0123456789abcdef

{
  "pagination": {
    "limit": 100,
    "offset": 0,
    "total": 2000,
    "max_results": 2000,
    "has_more": true,
    "next_offset": 100,
    "snapshot_id": "0123456789abcdef0123456789abcdef0123456789abcdef",
    "expires_at": "2026-06-26T12:40:00Z"
  }
}

Las solicitudes sin paginación utilizan la microcaché existente de 60 segundos y el mecanismo alternativo para datos históricos. La paginación almacena una instantánea inmutable en el Stats Redis local durante 600 segundos, con caducidad automática y sin renovación deslizante. Los inicios idénticos del mismo usuario en un intervalo de 60 segundos pueden reutilizar una instantánea, por lo que debe utilizar expires_at como fecha límite. Las continuaciones nunca vuelven a generar los datos ni utilizan otra instantánea como alternativa.

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