Stats

Traffic pulse — sites receiving views in a trailing window

Admin-only view of which sites got pageviews inside the trailing window, ordered by most-recent view, each with in-window totals and a bucketed series showing when the views landed. Window totals cover every active site; the row list is capped at siteLimit. Sites with no views in the window are absent — for the full directory use GET /stats/sites. Served from a short server-side cache (keyed per window preset).

get/stats/traffic

Request

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

Query parameters

window'1h' | '24h' | '7d' | '30d'

Trailing window the traffic pulse covers, ending now. Each window implies its bucket width (1h → 5m, 24h → 1h, 7d → 6h, 30d → 1d).

Response

window'1h' | '24h' | '7d' | '30d' required

Trailing window preset this response covers.

intervalstring required

Bucket width of the per-site series (implied by the window preset).

fromstring required

Window start (ISO 8601).

tostring required

Window end (ISO 8601).

bucketsstring[] required

UTC-floored start times of the series buckets, oldest first (ISO 8601). Every site row carries exactly one series entry per bucket.

pageviewsnumber required

Sample-corrected pageviews across all sites in the window.

uniqueVisitorsnumber required

Distinct visitors across all sites in the window (sum of per-site uniques; the visitor hash is site-scoped, so the sum is exact).

activeSitesnumber required

Number of sites that received at least one view in the window — may exceed sites.length when the list is capped at siteLimit.

siteLimitnumber required

Maximum rows the sites list carries. When activeSites exceeds this, the list holds the most recently viewed sites.

generatedAtstring required

When this snapshot was computed (ISO 8601).

Example response

{
  "interval": "1h",
  "sites": [
    {
      "subdomain": "my-site",
      "url": "https://my-site.nippy.site",
      "series": [
        0,
        2,
        5,
        0,
        1
      ]
    }
  ]
}

Changes

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