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.

Coba di API Playground

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