GET /v1/sources | Dokumentasi REST API NowMetrix

Permintaan

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

Gunakan endpoint khusus ini jika Anda ingin mengetahui asal pembaca live dan tidak memerlukan payload lengkap Halaman teratas realtime.

Autentikasi

Memerlukan kunci API pada header Authorization dengan nilai: Authorization: Bearer nm_YOUR_KEY.

Parameter kueri

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

Contoh cURL

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

Contoh respons

{
  "site": "TRACKER_ID",
  "updated_at": "2026-06-26T12:24:30+00:00",
  "total_visitors": 128,
  "sources": [
    {
      "medium": "search",
      "source": "Google Search",
      "count": 46,
      "percent": 36,
      "children": [
        {
          "label": "google.com",
          "count": 28
        },
        {
          "label": "google.ch",
          "count": 18
        }
      ]
    },
    {
      "medium": "social",
      "source": "social.example",
      "count": 24,
      "percent": 19,
      "children": []
    },
    {
      "medium": "newsletter",
      "source": "morning-briefing",
      "count": 17,
      "percent": 13,
      "children": [
        {
          "label": "daily-edition",
          "count": 11
        },
        {
          "label": "evening-edition",
          "count": 6
        }
      ]
    }
  ]
}

Kolom respons

Kolom	Tipe	Deskripsi
`site`	`string`	Tracker ID yang digunakan untuk permintaan.
`updated_at`	`string`	Stempel waktu UTC saat payload dibuat.
`total_visitors`	`integer`	Pengguna aktif yang tercakup dalam perincian sumber.
`sources[]`	`array<object>`	Baris sumber yang diurutkan berdasarkan jumlah.
`sources[].medium`	`string`	Kategori sumber, misalnya search, social, newsletter, (none), atau (not set) jika utm_source tidak memiliki utm_medium.
`sources[].source`	`string`	Label sumber yang dinormalisasi.
`sources[].count`	`integer`	Jumlah pengguna aktif dari sumber ini.
`sources[].percent`	`integer`	Persentase total pengunjung yang dibulatkan.
`sources[].children[]`	`array<object>`	Baris perincian opsional, seperti hostname pencarian atau nama kampanye.
`sources[].children[].label`	`string`	Label baris turunan.
`sources[].children[].count`	`integer`	Jumlah pada baris turunan.

Kesegaran data dan caching

Respons disimpan dalam microcache per tracker selama 8 detik. Respons juga menyertakan X-NowMetrix-Microcache dengan nilai HIT atau MISS.

Kesalahan

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`	Kunci API 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."
  }
}