GET /v1/overview | Dokumentasi REST API NowMetrix

Permintaan

GET https://api.nowmetrix.com/v1/overview?site=TRACKER_ID&days=7

Rute ringkas ini digunakan untuk laporan tren, impor BI, ekspor spreadsheet, serta ringkasan mingguan atau bulanan sederhana.

Autentikasi

API key wajib disertakan dalam header Authorization dengan nilai: Bearer nm_YOUR_KEY.

Parameter query

Nama	Tipe	Wajib	Deskripsi
`site`	`string`	wajib	Tracker ID. API key harus memiliki akses ke tracker ini.
`days`	`integer`	opsional	Jumlah hari yang dikembalikan. Nilai dibatasi antara 1 dan 30. Default: 30.

Contoh cURL

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

Contoh respons

{
  "site": "TRACKER_ID",
  "timezone": "Europe/Zurich",
  "range": {
    "from": "2026-06-20",
    "to": "2026-06-26",
    "days": 7
  },
  "daily": [
    {
      "date": "2026-06-20",
      "pageviews": 81240,
      "visits": 53210
    },
    {
      "date": "2026-06-21",
      "pageviews": 77480,
      "visits": 50195
    },
    {
      "date": "2026-06-22",
      "pageviews": 48215,
      "visits": 31890
    }
  ],
  "totals": {
    "pageviews": 206935,
    "visits": 135295
  }
}

Field respons

Field	Tipe	Deskripsi
`site`	`string`	Tracker ID yang digunakan dalam permintaan.
`timezone`	`string`	Zona waktu tracker yang digunakan untuk menentukan tanggal lokal.
`range.from`	`string`	Tanggal pertama dalam array harian yang dikembalikan.
`range.to`	`string`	Tanggal terakhir dalam array harian yang dikembalikan.
`range.days`	`integer`	Jumlah baris harian yang dikembalikan.
`daily[]`	`array<object>`	Baris harian yang diurutkan berdasarkan tanggal secara menaik.
`daily[].date`	`string`	Tanggal dalam format YYYY-MM-DD.
`daily[].pageviews`	`integer`	Pageviews untuk tanggal tersebut.
`daily[].visits`	`integer`	Kunjungan untuk tanggal tersebut.
`totals.pageviews`	`integer`	Jumlah pageviews dari seluruh baris harian yang dikembalikan.
`totals.visits`	`integer`	Jumlah kunjungan dari seluruh baris harian yang dikembalikan.

Kebaruan data dan caching

Respons disimpan dalam microcache berdasarkan tracker dan nilai days selama 60 detik, dengan periode stale singkat untuk melindungi sistem dari lonjakan permintaan.

Error

HTTP	Kode	Deskripsi
400	`site_required`	Parameter site yang wajib diisi tidak tersedia.
401	`missing_token`	Header Authorization tidak tersedia.
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 sedang tidak tersedia.

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