Endpoint REST API

GET /v1/pulse

Dnešní Pulse, srovnání se včerejškem a průběh dne v 15minutových intervalech.

Požadavek

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

Pomocí Pulse zjistíte víc než jen „Jakou máme návštěvnost?“: je dnešní návštěvnost nad obvyklým průběhem pro daný den týdne a čas, nebo pod ním?

Autentizace

Vyžaduje klíč API v hlavičce Authorization ve formátu: Bearer nm_YOUR_KEY.

Parametry dotazu

Název Typ Povinné Popis
site string povinné ID trackeru. Klíč API musí mít k tomuto trackeru přístup.

Příklad cURL

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

Příklad odpovědi

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

Pole odpovědi

Pole Typ Popis
site string ID trackeru použité v požadavku.
updated_at string Časové razítko UTC udávající, kdy byla odpověď vytvořena.
timezone string Časové pásmo trackeru použité k určení místních dat.
pulse.available boolean Určuje, zda je k dispozici dostatek historie pro výpočet Pulse.
pulse.reason string|null Důvod, proč Pulse není k dispozici.
pulse.delta_percent integer|null Celkový procentní rozdíl oproti referenčnímu základu.
pulse.days_counted integer Počet zahrnutých dnů referenčního základu.
pulse.is_provisional boolean Určuje, zda je výsledek Pulse předběžný.
pulse.minute_of_day integer Aktuální minuta místního dne použitá pro srovnání.
pulse.metrics.pageviews object Dnešní hodnota, průměr a delta_percent pro Zobrazení stránek.
pulse.metrics.visitors object Dnešní hodnota, průměr a delta_percent pro Návštěvníky.
pulse.metrics.active_users object Dnešní hodnota, průměr a delta_percent pro aktivní uživatele.
pulse.baseline object Metadata referenčního základu a vzorové dny použité k výpočtu Pulse.
yesterday_vs_day_before object Srovnání dokončeného dne podle Zobrazení stránek a Návštěvníků.
chart object 15minutové řady pro dnešek, včerejšek a průměr, rozdělené na Zobrazení stránek a Návštěvníky.

Aktuálnost a cachování

Odpovědi se pro každý tracker ukládají do mikrocache na 30 sekund. Kvůli ochraně před nárazovým zatížením lze po dalších 90 sekund použít zastaralou odpověď.

Chyby

HTTP Kód Popis
400 site_required Chybí povinný parametr site.
401 missing_token Chybí hlavička Authorization.
401 invalid_token Token je neplatný nebo odvolaný.
403 site_not_authorized Klíč API nemá k tomuto trackeru přístup.
429 rate_limit_exceeded Byl překročen limit požadavků.
503 redis_unavailable Backend Realtime je dočasně nedostupný. 
{
  "error": {
    "code": "invalid_token",
    "message": "Bearer token is invalid or revoked."
  }
}