Analytics API Linkly

Ekspor data klik dan laporan lalu lintas dari Linkly secara programatis menggunakan Analytics API kami.

Terkait: Link Shortening API | Webhooks

Sebelum Anda memulai

Linkly menghasilkan permintaan API di antarmuka untuk Anda salin dan tempel ke dalam aplikasi Anda.

Hemat waktu dan biarkan kami melakukan pekerjaan berat. API kami sepenuhnya dapat dikonsumsi oleh mesin.

Otorisasi

Anda akan memerlukan API Key dan Workspace ID. Anda dapat memperoleh detail ini dari dalam Linkly.

API laporan lalu lintas

Linkly secara otomatis menghasilkan permintaan API untuk Anda di dalam laporan lalu lintas Anda.

Laporan lalu lintas Linkly secara otomatis membangun permintaan API untuk Anda, berdasarkan data yang ditampilkan di layar.

Tautan ini mencakup kunci API Anda, dan mudah dapat disesuaikan dan digunakan dalam aplikasi Anda sendiri.

Format keluaran

Analytics API mendukung tiga format keluaran:

Mode pivot (format matriks)

Secara default, API mengembalikan data deret waktu dengan satu baris per tanggal. Dengan mode pivot, Anda dapat memperoleh lalu lintas semua tautan Anda dalam satu permintaan sebagai matriks.

Gunakan dropdown Export Data di laporan lalu lintas mana pun untuk dengan cepat mengekspor data berdasarkan tautan, atau tambahkan pivot=link_id ke permintaan API Anda.

Tambahkan pivot=link_id ke permintaan Anda untuk mendapatkan data dengan:

• Tanggal sebagai baris (satu baris per hari)
• Tautan sebagai kolom (satu kolom per tautan)

Contoh keluaran pivot CSV/TSV

Contoh keluaran pivot JSON

{
  "links": [
    {"id": 123, "name": "My Link", "full_url": "https://linkly.link/abc"},
    {"id": 456, "name": "Other Link", "full_url": "https://linkly.link/xyz"}
  ],
  "data": [
    {"date": "2025-12-30", "clicks": {"123": 45, "456": 12}},
    {"date": "2025-12-31", "clicks": {"123": 52, "456": 8}}
  ]
}

Mode pivot berguna untuk:

• Membandingkan lalu lintas di beberapa tautan
• Mengimpor ke spreadsheet untuk analisis
• Membangun dasbor dengan semua data tautan dalam satu panggilan

Data klik mentah

Data klik mentah yang kami catat, termasuk parameter lengkap, stempel waktu, dan informasi geolokasi, tersedia.

Untuk mengakses data ini, klik Export dari tab di bagian bawah dan pilih format Anda. Ini adalah permintaan API yang sepenuhnya terbentuk yang dapat Anda gunakan langsung dalam aplikasi Anda.

Catatan mengenai ekspor data

• Pertimbangkan untuk memfilter data dalam tampilan terlebih dahulu untuk mengurangi jumlah data yang diekspor. Fungsi ini mengekspor data dasar yang digunakan untuk menghasilkan laporan yang saat ini ada di layar.
• Data ini disimpan dalam cache hingga 3 jam. Permintaan berulang ke endpoint ini tidak akan menghasilkan data real-time.

Penghitungan yang dikelompokkan

Endpoint /counters/{dimension} mengembalikan total klik yang dikelompokkan berdasarkan dimensi tunggal — seperti country, platform, destination, referer, isp atau link_id. Hasil kembali diurutkan berdasarkan jumlah klik, tertinggi terlebih dahulu.

Maksimal 10.000 nilai yang dikembalikan. Dimensi kardinalitas tinggi — destination, referer, remote_ip dan isp — dapat memiliki nilai unik jauh lebih banyak daripada itu di ruang kerja yang sibuk. Ketika mereka melakukannya, Anda menerima 10.000 teratas berdasarkan jumlah klik dan sisanya tidak dikembalikan.

Bidang total selalu total klik di seluruh setiap grup, termasuk yang tidak dikembalikan. Jadi pada hasil yang terpotong, nilai count akan ditambahkan hingga kurang dari total — yang berarti persentase yang dihitung sebagai count / total masih akurat.

Jika Anda memerlukan set lengkap nilai daripada 10.000 teratas, ekspor data klik mentah dan agregasikan sendiri, atau gunakan integrasi BigQuery.

Notifikasi klik real-time

Untuk notifikasi klik real-time, lihat Webhooks. Webhook mengirimkan permintaan POST ke URL yang ditentukan segera ketika klik terjadi, dengan informasi rinci tentang klik.

Anda juga dapat mengelola webhook melalui API - lihat spesifikasi OpenAPI untuk detail.

Kebijakan penggunaan yang wajar

Batas kecepatan

Analytics API dibatasi hingga 50 permintaan per jam per ruang kerja.

Batas penggunaan

Selain batas kecepatan, Analytics API memiliki batas penggunaan yang diatur ulang setiap periode penagihan:

Apa yang dihitung sebagai penggunaan

• Permintaan API: Setiap panggilan ke endpoint Analytics API (/clicks, /counters, /export) dihitung sebagai satu permintaan.
• Data Dipindai: Jumlah data yang diproses oleh database analitik kami untuk memenuhi permintaan Anda. Rentang tanggal yang lebih besar dan kueri yang lebih kompleks memindai lebih banyak data.

Apa yang terjadi ketika Anda melebihi batas

Jika Anda melebihi batas penggunaan Anda:

1. 1
   Permintaan API akan mengembalikan kesalahan 429 Too Many Requests
2. 2
   Batas Anda akan otomatis diatur ulang di awal periode penagihan berikutnya
3. 3
   Tautan Anda akan terus berfungsi dan melacak klik secara normal

Tips untuk mengurangi penggunaan

Sebagian besar pengguna dapat memperoleh semua data mereka dalam satu permintaan API menggunakan mode pivot (pivot=link_id), yang mengembalikan lalu lintas semua tautan sebagai matriks dalam satu panggilan.

• Gunakan mode pivot: Tambahkan pivot=link_id untuk mendapatkan lalu lintas untuk semua tautan dalam satu permintaan alih-alih menanyakan setiap tautan secara terpisah
• Respons cache: Simpan respons API secara lokal alih-alih mengambil data yang sama berulang kali
• Gunakan rentang tanggal yang lebih kecil: Tanyakan hanya tanggal yang Anda butuhkan
• Permintaan batch: Gabungkan beberapa kueri tautan ke dalam satu permintaan menggunakan parameter link_ids

Butuh lebih banyak?

Jika Anda memerlukan batas yang lebih tinggi, silakan hubungi kami menggunakan widget dukungan.

Integrasi BigQuery

Untuk kebutuhan analitik volume tinggi, Linkly menawarkan integrasi BigQuery yang menyediakan akses SQL langsung ke data klik Anda.

• Akses data langsung - Tanyakan data klik Anda secara langsung di BigQuery dengan pembaruan real-time
• Kueri tanpa batas - Tanpa batas kecepatan API; Anda hanya membayar untuk komputasi BigQuery
• Pelaporan kustom - Bangun dasbor dengan Looker, Data Studio, atau Tableau
• Konsolidasi data - Gabungkan data klik dengan metrik bisnis lainnya

Integrasi BigQuery disertakan dalam paket Enterprise. Hubungi kami untuk detail.

Pelajari lebih lanjut tentang Integrasi BigQuery →

Terkait

• Link Shortening API - Buat dan perbarui tautan secara programatis
• Webhooks - Notifikasi klik real-time
• Integrasi BigQuery - Akses SQL langsung ke data klik
• Integrasi Zapier - Integrasi tanpa kode