Stats

Windowed growth series (per-bucket + cumulative curves)

Admin-only bucketed growth series (sites, verified users, pageviews — per-bucket and cumulative) over the requested window + bucket width. The user curves count verified users only. The heavier half of the old snapshot, split out so the Overview tab need not pay for it. Served from a short server-side cache.

get/stats/growth

Request

  • Base URL: https://api.nippy.host
  • URL: https://api.nippy.host/stats/growth
  • 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 growth series covers, in days.

fromstring required

Start of the growth window (ISO 8601).

tostring required

End of the growth window (ISO 8601).

generatedAtstring required

When this series 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.