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 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.
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 PlaygroundAutentikasi
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."
}
}