GET /v1/pulse | NowMetrix-documentatie voor de REST API

Aanvraag

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

Gebruik Pulse om een nuttigere vraag te beantwoorden dan 'Hoeveel verkeer hebben we?': ligt het verkeer vandaag boven of onder het normale patroon voor deze weekdag en dit tijdstip?

Authenticatie

Vereist een API-sleutel in de Authorization-header: Authorization: Bearer nm_YOUR_KEY.

Queryparameters

Naam	Type	Vereist	Beschrijving
`site`	`string`	vereist	Tracker-ID. De API-sleutel moet toegang hebben tot deze tracker.

cURL-voorbeeld

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

Voorbeeldrespons

{
  "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
        }
      ]
    }
  }
}

Responsvelden

Veld	Type	Beschrijving
`site`	`string`	De Tracker-ID die voor de aanvraag is gebruikt.
`updated_at`	`string`	UTC-tijdstip waarop de payload is gegenereerd.
`timezone`	`string`	Tijdzone van de tracker die wordt gebruikt om lokale datums te bepalen.
`pulse.available`	`boolean`	Geeft aan of er voldoende historische gegevens beschikbaar zijn om Pulse te berekenen.
`pulse.reason`	`string\|null`	Reden waarom Pulse niet beschikbaar is.
`pulse.delta_percent`	`integer\|null`	Het totale procentuele verschil ten opzichte van de baseline.
`pulse.days_counted`	`integer`	Aantal opgenomen dagen in de baseline.
`pulse.is_provisional`	`boolean`	Geeft aan of het Pulse-resultaat voorlopig is.
`pulse.minute_of_day`	`integer`	Huidige minuut van de lokale dag die voor de vergelijking wordt gebruikt.
`pulse.metrics.pageviews`	`object`	Pageviews van vandaag, het gemiddelde en delta_percent.
`pulse.metrics.visitors`	`object`	Bezoekers van vandaag, het gemiddelde en delta_percent.
`pulse.metrics.active_users`	`object`	Actieve gebruikers van vandaag, het gemiddelde en delta_percent.
`pulse.baseline`	`object`	Metagegevens van de baseline en de historische dagen die voor de Pulse-berekening zijn gebruikt.
`yesterday_vs_day_before`	`object`	Vergelijking van voltooide dagen voor Pageviews en bezoekers.
`chart`	`object`	Reeksen per 15 minuten voor vandaag, gisteren en het gemiddelde, uitgesplitst naar Pageviews en bezoekers.

Actualiteit en caching

Responsen worden per tracker 30 seconden in de cache gehouden, met een venster van 90 seconden waarin verouderde gegevens worden gebruikt ter bescherming tegen piekbelasting.

Foutmeldingen

HTTP	Code	Beschrijving
400	`site_required`	De vereiste siteparameter ontbreekt.
401	`missing_token`	De Authorization-header ontbreekt.
401	`invalid_token`	Het token is ongeldig of ingetrokken.
403	`site_not_authorized`	De API-sleutel heeft geen toegang tot deze tracker.
429	`rate_limit_exceeded`	De rate limit is overschreden.
503	`redis_unavailable`	De realtimebackend is tijdelijk niet beschikbaar.

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