API Statistik Klik Bulanan

Mengambil jumlah klik per bulan (YYYY-MM) dalam rentang tanggal tertentu.

Analisis tren trafik jangka panjang dan pola pertumbuhan untuk memahami performa campaign serta perilaku pengguna.

API ini tersedia mulai paket Personal ke atas.

GET

/api/statistics/v1/clicks-by-month?startYm={startYm}&endYm={endYm} 


GET /api/statistics/v1/clicks-by-month
     ?startYm=2026-01
     &endYm=2026-04

Request Parameters

startYm string required
Tahun dan bulan awal untuk query. Gunakan format YYYY-MM. Contoh: 2026-01
endYm string required
Tahun dan bulan akhir untuk query. Gunakan format YYYY-MM. Contoh: 2026-04
Rentang tanggal yang diperbolehkan bergantung pada paket.
Personal: hingga 90 hari terakhir
Premium: hingga 180 hari terakhir
Business: hingga 365 hari terakhir
linkId string
ID link. Jika mengandung karakter khusus atau Unicode, wajib menggunakan URL encoding.
Personal: linkId dan domain wajib. Hanya data dari link individu yang dapat diambil.
Premium ke atas: opsional.
domain string
Domain link. Mendukung penggunaan custom domain.
grpIdx integer
ID grup link. Nilai IDX dapat diperoleh melalui API daftar grup atau dari dashboard.
Jika ditentukan, total klik dari semua link dalam grup akan dikembalikan.
Tersedia mulai paket Premium ke atas. 
{
    "code": 0,
    "message": "",
    "result": [
        {
            "ym": "2026-01",
            "acesCnt": 384,
            "pernCnt": 295
        },
        {
            "ymd": "2026-02",
            "acesCnt": 1785,
            "pernCnt": 1720
        },
        {
            "ymd": "2026-03",
            "acesCnt": 19542,
            "pernCnt": 19083
        },
        {
            "ymd": "2026-04",
            "acesCnt": 3596,
            "pernCnt": 3274
        }
    ]
}

Response Parameters

codeinteger
Kode respons: 0 = Berhasil, nilai lain = Error
messagestring
Pesan respons. Jika kode tidak sama dengan 0, pesan kesalahan akan dikembalikan.
resultarray
ym string
Tahun dan bulan, dikembalikan dalam format YYYY-MM. Contoh: 2026-01
acesCnt integer
Jumlah total klik pada bulan yang ditentukan.
pernCnt integer
Jumlah pengguna unik yang mengklik link selama bulan tersebut.

Kapan menggunakan API ini

Gunakan API ini untuk menganalisis tren trafik link secara bulanan.

Cocok untuk merangkum performa campaign per kuartal atau semester, menganalisis pola musiman, serta menyusun laporan tahunan.

Dibandingkan dengan API klik per tanggal, API ini lebih tepat untuk analisis tren jangka panjang.

Perbedaan dengan API klik per tanggal

API klik per tanggal mengelompokkan data per hari dan cocok untuk analisis jangka pendek, sedangkan API bulanan mengelompokkan data per bulan untuk analisis jangka panjang.
Selain itu, tergantung paket, API ini mendukung hingga 365 hari, sehingga cocok untuk analisis tahunan.
※ Paket Business Plus dan Enterprise dapat mendukung hingga 2 tahun sesuai kontrak

Batas query berdasarkan paket

API ini tersedia mulai paket Personal ke atas. Rentang query berbeda tergantung paket.

Paket Personal mendukung hingga 90 hari terakhir, Premium hingga 180 hari, dan Business hingga 365 hari.
Query berbasis grup menggunakan grpIdx hanya tersedia pada paket Premium ke atas.

Metrik utama dan analisis

API ini menyediakan data agregasi bulanan.

Klik bulanan (accsCnt)

  • Total klik per bulan
  • Memantau tren kenaikan atau penurunan trafik

Pengguna (pernCnt)

  • Jumlah pengguna unik per bulan
  • Mengukur volume trafik aktual

Metrik ini membantu menganalisis pertumbuhan, pola musiman, dan performa jangka panjang.

Contoh penggunaan

  • Laporan kuartalan: Tentukan periode dengan startYm dan endYm untuk menganalisis tren klik bulanan
  • Analisis musiman: Ambil data selama 1 tahun untuk mengidentifikasi bulan dengan trafik tertinggi
  • Tren campaign jangka panjang: Gunakan grpIdx untuk menganalisis pola klik bulanan dalam satu grup
  • Laporan tahunan: Pada paket Business, kumpulkan hingga 365 hari data untuk laporan tahunan

Hal yang perlu diperhatikan

  • startYm dan endYm adalah parameter wajib dan harus menggunakan format YYYY-MM.
  • Rentang maksimum tergantung paket. Jika melebihi batas, akan terjadi error.
  • Jika linkId mengandung karakter khusus atau Unicode, wajib menggunakan URL encoding.
  • API ini tersedia mulai paket Personal. Pastikan paket Anda sebelum digunakan.