GET /v1/pulse | Dokumentasi REST API NowMetrix

Permintaan

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

Gunakan Pulse untuk menjawab pertanyaan yang lebih berguna daripada 'Berapa banyak lalu lintas yang kami dapatkan?': apakah lalu lintas hari ini berada di atas atau di bawah pola normal untuk hari dan waktu yang sama?

Autentikasi

Memerlukan API key dalam header Authorization dengan nilai Authorization: Bearer nm_YOUR_KEY.

Parameter kueri

Nama	Tipe	Wajib	Deskripsi
`site`	`string`	wajib	Tracker ID. API key harus memiliki akses ke tracker ini.

Contoh cURL

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

Contoh respons

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

Field respons

Field	Tipe	Deskripsi
`site`	`string`	Tracker ID yang digunakan dalam permintaan.
`updated_at`	`string`	Timestamp UTC saat payload dibuat.
`timezone`	`string`	Zona waktu tracker yang digunakan untuk menentukan tanggal lokal.
`pulse.available`	`boolean`	Menunjukkan apakah tersedia riwayat yang cukup untuk menghitung Pulse.
`pulse.reason`	`string\|null`	Alasan ketika Pulse tidak tersedia.
`pulse.delta_percent`	`integer\|null`	Selisih persentase keseluruhan dibandingkan dengan baseline.
`pulse.days_counted`	`integer`	Jumlah hari baseline yang disertakan.
`pulse.is_provisional`	`boolean`	Menunjukkan apakah hasil Pulse masih bersifat sementara.
`pulse.minute_of_day`	`integer`	Menit saat ini dalam hari lokal yang digunakan untuk perbandingan.
`pulse.metrics.pageviews`	`object`	Nilai hari ini, rata-rata, dan delta_percent untuk pageviews.
`pulse.metrics.visitors`	`object`	Nilai hari ini, rata-rata, dan delta_percent untuk pengunjung.
`pulse.metrics.active_users`	`object`	Nilai hari ini, rata-rata, dan delta_percent untuk pengguna aktif.
`pulse.baseline`	`object`	Metadata baseline dan hari sampel yang digunakan untuk menghitung Pulse.
`yesterday_vs_day_before`	`object`	Perbandingan antara hari yang telah selesai dan hari sebelumnya untuk pageviews dan pengunjung.
`chart`	`object`	Rangkaian data dalam interval 15 menit untuk hari ini, kemarin, dan rata-rata, yang dibagi menjadi pageviews dan pengunjung.

Pembaruan data dan caching

Respons disimpan dalam microcache per tracker selama 30 detik, dengan jendela stale selama 90 detik untuk melindungi dari lonjakan permintaan.

Error

HTTP	Kode	Deskripsi
400	`site_required`	Parameter site yang wajib tidak ada.
401	`missing_token`	Header Authorization tidak ada.
401	`invalid_token`	Token tidak valid atau telah dicabut.
403	`site_not_authorized`	API key tidak memiliki akses ke tracker ini.
429	`rate_limit_exceeded`	Batas laju permintaan telah terlampaui.
503	`redis_unavailable`	Backend realtime untuk sementara tidak tersedia.

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