Analytics API Linkly

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

Terkait: Link Shortening API | Webhooks

Sebelum Anda mulai

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

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

Otorisasi

Anda memerlukan Kunci API dan ID Ruang Kerja. Anda dapat mendapatkan 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 membuat permintaan API untuk Anda, berdasarkan data yang ditampilkan di layar.

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

Format output

Analytics API mendukung tiga format output:

Mode pivot (format matriks)

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

Gunakan dropdown Ekspor Data di laporan lalu lintas apa 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 output pivot CSV/TSV

Contoh output pivot JSON

{
  "links": [
    {"id": 123, "name": "Tautan Saya", "full_url": "https://linkly.link/abc"},
    {"id": 456, "name": "Tautan Lain", "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 rekam, termasuk parameter lengkap, stempel waktu, dan informasi geolokasi, tersedia.

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

Catatan mengenai ekspor data

• Pertimbangkan pemfilteran 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 di-cache hingga 3 jam. Permintaan berulang ke titik akhir ini tidak akan menghasilkan data real-time.

Penghitungan yang dikelompokkan

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

Maksimal 10.000 nilai dikembalikan. Dimensi tinggi-kardinalitas — destination, referer, remote_ip dan isp — dapat memiliki jauh lebih banyak nilai distinc 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 merupakan total klik di setiap grup, termasuk yang tidak dikembalikan. Jadi pada hasil yang dipotong, nilai count akan ditambahkan hingga kurang dari total — yang berarti persentase yang dihitung sebagai count / total masih akurat.

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

Notifikasi klik real-time

Untuk notifikasi klik real-time, lihat Webhooks. Webhook mengirim permintaan POST ke URL yang Anda tentukan segera ketika klik terjadi, dengan informasi terperinci tentang klik.

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

Kebijakan penggunaan yang adil

Batas laju

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

Batas penggunaan

Selain batas laju, Analytics API memiliki batas penggunaan yang disetel ulang setiap periode penagihan:

Apa yang dihitung sebagai penggunaan

• Permintaan API: Setiap panggilan ke titik akhir Analytics API (/clicks, /counters, /export) dihitung sebagai satu permintaan. Ekspor tautan (/links/export) yang dibuat dengan kunci API juga dihitung sebagai satu permintaan.
• Data yang 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 melampaui batas

Ketika ruang kerja pada paket berbayar menggunakan semua permintaan API-nya, kami secara otomatis menambahkan paket API ke langganannya sehingga integrasi Anda terus bekerja, dan mengirim email kepada anggota ruang kerja untuk memberitahu mereka. Paket API menambahkan permintaan API ekstra setiap periode penagihan hingga Anda menghapusnya.

Permintaan API mengembalikan kesalahan 429 Too Many Requests sebagai gantinya ketika:

1. 1
   Ruang kerja berada pada paket Gratis atau Starter, yang tidak dapat menambahkan paket API
2. 2
   Langganan ruang kerja disetel untuk dibatalkan, atau pembayaran tertunda
3. 3
   Ruang kerja telah menggunakan semua tunjangan data yang dipindainya — paket API menambahkan permintaan, bukan data

Batas penggunaan disetel ulang di awal setiap periode penagihan, dan tautan Anda terus bekerja dan melacak klik secara normal.

Tips untuk mengurangi penggunaan

Kebanyakan pengguna dapat mendapatkan 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 semua tautan dalam satu permintaan alih-alih menanyakan setiap tautan secara terpisah
• Simpan respons: 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?

Anda dapat menambahkan paket API sendiri kapan saja di bawah Add-ons di halaman Penagihan. Setiap paket menambahkan permintaan API ekstra setiap periode penagihan; halaman menunjukkan harga untuk paket Anda sebelum Anda mengonfirmasi.

Paket API tidak mengubah batas laju. Jika Anda memerlukan batas laju yang lebih tinggi, silakan hubungi kami menggunakan widget dukungan.

Integrasi BigQuery

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

• Akses data langsung - Tanyakan data klik Anda langsung di BigQuery dengan pembaruan real-time
• Kueri tanpa batas - Tidak ada batas laju API; Anda hanya membayar untuk komputasi BigQuery
• Pelaporan khusus - 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 selengkapnya tentang Integrasi BigQuery →

Terkait

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