Stats

Aggregate platform statistics (deprecated — use overview + growth)

Admin-only snapshot of platform-wide counts plus windowed traffic and growth series. Superseded by the lighter GET /stats/overview (snapshot + deltas) and GET /stats/growth (series only), which the dashboard now loads independently per tab; retained for backward compatibility. Returns only aggregate figures. Served from a short server-side cache.

get/stats

Request

  • Base URL: https://api.nippy.host
  • URL: https://api.nippy.host/stats
  • Auth: bearer (a scheme the document does not define)

Query parameters

fromstring

Window start, ISO 8601. Omit for the trailing 30 days; pass an explicit start (or all-time via a very early date) to widen the growth charts.

tostring

Window end, ISO 8601. Defaults to now; clamped to now.

interval'1m' | '5m' | '15m' | '1h' | '3h' | '6h' | '1d' | '1w'

Growth-series bucket width (spacing between points). Must be one of the widths allowed for the window's duration; an unsupported value is clamped to that duration's default.

tzOffsetnumber

Viewer's UTC offset in minutes, east-positive (-new Date().getTimezoneOffset()). Growth buckets are aligned to the viewer’s local day/week boundaries using this. Defaults to 0 (UTC).

Response

windowDaysnumber required

Window the traffic and growth figures cover, in days (the resolved span from from to to, rounded to whole days).

fromstring required

Start of the windowed traffic/growth figures (ISO 8601).

tostring required

End of the windowed traffic/growth figures (ISO 8601).

generatedAtstring required

When this snapshot was computed (ISO 8601).

Example response

{
  "growth": {
    "buckets": [
      "2026-06-01T00:00:00.000Z",
      "2026-06-02T00:00:00.000Z"
    ],
    "sites": [
      0,
      0,
      1,
      3,
      2,
      0,
      5
    ],
    "sitesCumulative": [
      40,
      40,
      41,
      44,
      46,
      46,
      51
    ],
    "verifiedUsers": [
      1,
      0,
      2,
      4,
      1,
      0,
      3
    ],
    "verifiedUsersCumulative": [
      55,
      55,
      57,
      61,
      62,
      62,
      65
    ],
    "pageviews": [
      120,
      98,
      240,
      310,
      205,
      0,
      540
    ],
    "pageviewsCumulative": [
      12000,
      12098,
      12338,
      12648,
      12853,
      12853,
      13393
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.