Endpoint REST API

GET /v1/sources-history

Campuran lalu lintas dari waktu ke waktu: rata-rata jumlah pembaca serentak di setiap kategori sumber selama satu jam terakhir, 24 jam terakhir, hari ini, kemarin, 7 hari terakhir, atau rentang tanggal khusus.

Permintaan

Riwayat tersedia sejak 16 November 2026

Riwayat sumber mulai direkam pada 16 November 2026 dan terus bertambah setiap hari. Perekaman dimulai sekitar pukul 16.00 UTC, sehingga data 16 November hanya mencakup jam-jam sore dan nilai hariannya tidak dapat dibandingkan dengan nilai untuk hari penuh. Jika rentang mencakup waktu sebelum 16 November 2026, nilai from akan digeser ke tanggal tersebut dan respons akan menyertakan pemberitahuan. Jika rentang berakhir sebelum tanggal tersebut, respons tidak memuat titik data. Waktu sebelum tanggal tersebut tidak pernah dilaporkan sebagai nol.

GET https://api.nowmetrix.com/v1/sources-history?site=TRACKER_ID&range=today

Gunakan endpoint ini untuk melihat perubahan campuran lalu lintas dari waktu ke waktu, misalnya untuk mengetahui kapan lalu lintas Google Discover mulai muncul atau apakah lalu lintas dari penelusuran organik lebih rendah daripada kemarin. Setiap titik data menunjukkan rata-rata jumlah pembaca serentak di setiap kategori sumber pada waktu tersebut. Nilai ini bukan jumlah kunjungan atau pageview dan tidak boleh dijumlahkan dari waktu ke waktu; gunakan /v1/recap atau /v1/overview untuk melihat total. Untuk sumber live tertentu, seperti jejaring sosial atau buletin, gunakan /v1/sources.

Coba di API Playground

Autentikasi

Gunakan API key pada header Authorization dengan format Authorization: Bearer nm_YOUR_KEY.

Parameter kueri

Nama Tipe Wajib Deskripsi
site string wajib Tracker ID. API key harus memiliki akses ke tracker ini.
range string opsional Rentang waktu. Pilih salah satu: 1h (60 menit terakhir, titik data per 2 menit), 24h (24 jam terakhir, titik data per 10 menit), today dan yesterday (hari kalender sesuai zona waktu tracker, titik data per 10 menit), 7d (hari ini dan 6 hari sebelumnya, titik data per jam), atau custom (memerlukan start dan end). Default: today.
start string opsional Hari kalender pertama untuk rentang khusus, dengan format YYYY-MM-DD sesuai zona waktu tracker. Wajib diisi bersama range=custom dan tidak boleh digunakan dengan rentang lain. Tanggal tidak boleh berada di masa mendatang.
end string opsional Hari kalender terakhir untuk rentang khusus, dengan format YYYY-MM-DD, dan tanggal ini termasuk dalam rentang. Wajib diisi bersama range=custom. Rentang dapat mencakup maksimal 366 hari; tanggal akhir di masa mendatang akan dibatasi hingga waktu saat ini. Resolusi mengikuti jumlah hari yang memiliki data: titik data per 10 menit untuk rentang hingga 2 hari, per jam untuk rentang hingga 31 hari, dan per hari untuk rentang yang lebih panjang.

Contoh cURL

curl -H "Authorization: Bearer nm_YOUR_KEY" \
  "https://api.nowmetrix.com/v1/sources-history?site=TRACKER_ID&range=today"

Contoh respons

{
  "site": "TRACKER_ID",
  "range": "today",
  "start": null,
  "end": null,
  "timezone": "Europe/Zurich",
  "unit": "avg_concurrent_readers",
  "resolution_minutes": 10,
  "from": "2026-11-18T00:00:00+01:00",
  "to": "2026-11-18T09:24:00+01:00",
  "data_available_from": "2026-11-16",
  "notice": null,
  "updated_at": "2026-11-18T08:24:30+00:00",
  "stale": false,
  "categories": [
    "organic",
    "discover",
    "direct",
    "internal",
    "social",
    "referral",
    "email",
    "ai"
  ],
  "points": [
    {
      "t": "2026-11-18T09:00:00+01:00",
      "total": 412.6,
      "unattributed": 6.4,
      "values": {
        "organic": 96.2,
        "discover": 131.5,
        "direct": 88.1,
        "internal": 41.3,
        "social": 27.9,
        "referral": 12.6,
        "email": 7.2,
        "ai": 1.4
      }
    },
    {
      "t": "2026-11-18T09:10:00+01:00",
      "total": 428.3,
      "unattributed": 5.9,
      "values": {
        "organic": 98.7,
        "discover": 144,
        "direct": 86.4,
        "internal": 42.8,
        "social": 28.5,
        "referral": 12.1,
        "email": 8.6,
        "ai": 1.3
      }
    }
  ]
}

Field respons

Field Tipe Deskripsi
site string Tracker ID yang digunakan dalam permintaan.
range string Rentang waktu yang diminta.
start string|null Hari pertama yang diminta untuk range=custom; selain itu, nilainya null.
end string|null Hari terakhir yang diminta untuk range=custom; selain itu, nilainya null.
timezone string Zona waktu tracker yang digunakan untuk hari kalender dan stempel waktu, misalnya Europe/Zurich.
unit string Selalu bernilai avg_concurrent_readers: rata-rata jumlah pembaca yang aktif bersamaan dalam setiap titik data.
resolution_minutes integer Durasi setiap titik data dalam menit: 2, 10, 60, atau 1440 (satu hari kalender).
from string Awal rentang dalam format stempel waktu ISO 8601 dengan offset zona waktu tracker. Jika rentang yang diminta dimulai sebelum data_available_from, nilai ini akan digeser ke tanggal tersebut.
to string Akhir rentang dalam format stempel waktu ISO 8601 dengan offset. Untuk rentang yang masih berlangsung, nilainya adalah waktu saat ini.
data_available_from string Hari pertama dengan riwayat sumber yang tercatat: 2026-11-16. Perekaman dimulai sekitar pukul 16.00 UTC pada hari itu, sehingga datanya tidak mencakup satu hari penuh.
notice object|null Diisi jika rentang mencakup waktu sebelum data_available_from; selain itu, nilainya null. Permintaan tetap berhasil dengan HTTP 200.
notice.code string partial_history: rentang dimulai lebih awal, sehingga from digeser dan tidak ada titik data untuk hari-hari sebelumnya. no_history: rentang berakhir sebelum perekaman data dimulai, sehingga points kosong.
notice.message string Penjelasan singkat dalam bahasa Inggris untuk log atau ditampilkan kepada pengguna.
updated_at string Stempel waktu UTC saat riwayat dihitung.
stale boolean Bernilai true jika hasil ini adalah hasil valid terakhir karena backend riwayat untuk sementara tidak tersedia.
categories[] array<string> Semua kategori sumber dalam urutan tetap: organic, discover, direct, internal, social, referral, email, ai. Daftar ini selalu lengkap, termasuk kategori yang tidak memiliki pembaca.
points[] array<object> Titik data dalam urutan kronologis. Waktu tanpa data yang terkumpul tidak disertakan, sehingga mungkin ada jeda.
points[].t string Awal titik data dalam format stempel waktu ISO 8601 dengan offset. Saat jam dimundurkan pada akhir waktu musim panas (DST), jam yang berulang digabungkan menjadi satu titik data.
points[].total number Rata-rata jumlah pembaca serentak dari semua sumber, dibulatkan ke satu angka desimal.
points[].unattributed number Jumlah pembaca dalam total yang tidak dapat dimasukkan ke kategori mana pun. Saat ini, nilainya biasanya 0, sehingga jumlah seluruh kategori sama dengan total. Selalu hitung proporsi dengan membagi nilai kategori dengan total agar hasil tetap akurat jika ada pembaca yang tidak dapat dikategorikan.
points[].values object Rata-rata jumlah pembaca serentak per kategori, dengan nama kategori dari categories sebagai kunci. Kategori tanpa pembaca bernilai 0.

Kebaruan data dan cache

Respons disimpan dalam cache berdasarkan tracker dan rentang: 60 detik untuk 1h, 24h, dan today; 5 menit untuk 7d; serta 30 menit untuk yesterday. Rentang khusus disimpan dalam cache berdasarkan tanggal mulai dan akhir: 30 menit jika rentang sudah berakhir; jika belum, 60 detik untuk titik data per 10 menit dan 5 menit untuk titik data per jam atau per hari. Jika backend riwayat untuk sementara tidak tersedia, hasil valid terakhir akan dikembalikan dengan stale: true dan header Warning. Respons juga menyertakan X-NowMetrix-Microcache dengan nilai HIT, MISS, atau STALE.

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 sudah dicabut.
403 site_not_authorized API key tidak memiliki akses ke tracker ini.
429 rate_limit_exceeded Batas frekuensi permintaan telah terlampaui.
503 redis_unavailable Backend real-time untuk sementara tidak tersedia.
400 invalid_range Parameter range harus bernilai 1h, 24h, today, yesterday, 7d, atau custom.
400 invalid_date_range start atau end tidak ada atau bukan tanggal YYYY-MM-DD yang valid; start setelah end atau berada di masa mendatang; rentang mencakup lebih dari 366 hari; atau start dan end dikirim tanpa range=custom.
503 source_history_unavailable Riwayat sumber untuk sementara tidak tersedia dan tidak ada hasil terbaru yang tersimpan dalam cache. Coba lagi setelah waktu yang tercantum di header Retry-After.
{
  "error": {
    "code": "invalid_token",
    "message": "Bearer token is invalid or revoked."
  }
}