REST-API-Endpoint

GET /v1/pulse

Pulse vo hüt, Vergliich mit geschter und Intraday-Kurve im 15-Minute-Takt.

Abfrag

GET https://api.nowmetrix.com/v1/pulse?site=TRACKER_ID

Mit Pulse chönd Si e nützlichere Frag beantworte als «Wie viel Traffic händ mir?»: Liegt de Traffic hüt über oder under em normale Muster für dä Wuchetag und die Ziit?

Authentifizierig

D Abfrag bruucht en API-Key im Authorization-Header: Authorization: Bearer nm_YOUR_KEY.

Abfrageparameter

Name Typ Erforderlich Beschriibig
site string erforderlich Tracker-ID. De API-Key muess Zuegriff uf dä Tracker ha.

cURL-Biispil

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

Biispilantwort

{
  "site": "TRACKER_ID",
  "updated_at": "2026-06-26T12:24:30Z",
  "timezone": "Europe/Zurich",
  "pulse": {
    "available": true,
    "reason": null,
    "delta_percent": 12,
    "days_counted": 8,
    "is_provisional": false,
    "minute_of_day": 865,
    "metrics": {
      "pageviews": {
        "today": 48215,
        "avg": 43040,
        "delta_percent": 12
      },
      "visitors": {
        "today": 31890,
        "avg": 29620,
        "delta_percent": 8
      },
      "active_users": {
        "today": 128,
        "avg": 104,
        "delta_percent": 23
      }
    },
    "baseline": {
      "snapshot_time": "14:25",
      "aggregation": "median",
      "combination": "mean_of_deltas",
      "days_counted": 8,
      "samples": [
        {
          "date": "2026-06-19",
          "pageviews": 42110,
          "visitors": 29100,
          "active_users": 98
        }
      ]
    }
  },
  "yesterday_vs_day_before": {
    "yesterday": {
      "date": "2026-06-25",
      "pageviews": 77480,
      "visitors": 50195
    },
    "day_before": {
      "date": "2026-06-24",
      "pageviews": 81240,
      "visitors": 53210
    },
    "delta_percent": {
      "pageviews": -5,
      "visitors": -6
    }
  },
  "chart": {
    "interval_minutes": 15,
    "today_date": "2026-06-26",
    "yesterday_date": "2026-06-25",
    "average_basis_days": 8,
    "average_method": "median_same_weekday",
    "pageviews": {
      "today": [
        {
          "time": "08:00",
          "value": 920
        },
        {
          "time": "08:15",
          "value": 1110
        }
      ],
      "yesterday": [
        {
          "time": "08:00",
          "value": 870
        }
      ],
      "average": [
        {
          "time": "08:00",
          "value": 810
        }
      ]
    },
    "visitors": {
      "today": [
        {
          "time": "08:00",
          "value": 620
        }
      ],
      "yesterday": [
        {
          "time": "08:00",
          "value": 580
        }
      ],
      "average": [
        {
          "time": "08:00",
          "value": 540
        }
      ]
    }
  }
}

Antwortfelder

Feld Typ Beschriibig
site string Tracker-ID, wo für d Abfrag verwendet worde isch.
updated_at string UTC-Ziitstempel, wo zeigt, wenn d Date generiert worde sind.
timezone string Ziitzone vom Tracker, mit dere lokali Täg bestimmt werde.
pulse.available boolean Öb gnueg Verlauf für d Pulsberechnig verfüegbar isch.
pulse.reason string|null Grund, wenn de Puls nöd verfüegbar isch.
pulse.delta_percent integer|null Gesamti prozentuali Abwiichig vo de Basislinie.
pulse.days_counted integer Aazahl vo de berücksichtigte Basis-Täg.
pulse.is_provisional boolean Öb s Pulsresultat vorläufig isch.
pulse.minute_of_day integer Aktuelli Minute im lokale Tag, wo für de Vergliich verwendet wird.
pulse.metrics.pageviews object Hüt, Durchschnitt und delta_percent für Pageviews.
pulse.metrics.visitors object Hüt, Durchschnitt und delta_percent für Bsuecher.
pulse.metrics.active_users object Hüt, Durchschnitt und delta_percent für aktivi Nutzer.
pulse.baseline object Metadate zur Basislinie und zu de Täg, wo für d Pulsberechnig verwendet werde.
yesterday_vs_day_before object Vergliich vo de abgschlossene Täg für Pageviews und Bsuecher.
chart object Serie im 15-Minute-Takt für hüt, geschter und de Durchschnitt, unterteilt i Pageviews und Bsuecher.

Aktualität und Caching

Antworte werded pro Tracker 30 Sekunde im Microcache zwüschegspeicheret. Zum Schutz vor Lastspitze chönd veralteti Antwort während eme zusätzliche 90-sekündige Stale-Fänschter usglieferet werde.

Fähler

HTTP Code Beschriibig
400 site_required De erforderliche site-Parameter fehlt.
401 missing_token De Authorization-Header fehlt.
401 invalid_token De Token isch ungültig oder widerruefe worde.
403 site_not_authorized De API-Key het kei Zuegriff uf dä Tracker.
429 rate_limit_exceeded S Rate-Limit isch überschritte worde.
503 redis_unavailable S Realtime-Backend isch vorübergehend nöd verfüegbar. 
{
  "error": {
    "code": "invalid_token",
    "message": "Bearer token is invalid or revoked."
  }
}