Linkly'nin Analytics API'si

Linkly'den Analytics API'mizi kullanarak tıklama verilerini ve trafik raporlarını programlı olarak dışa aktarın.

İlgili: Link Kısaltma API'si | Webhooklar

Başlamadan önce

Linkly, arayüzde API isteklerini sizin için oluşturur ve uygulamalarınıza kopyalayıp yapıştırabilirsiniz.

Zaman kazanın ve bize ağır işi yaptırın. API'miz tamamen makine tarafından okunabilir.

Yetkilendirme

API Anahtarınız ve Workspace ID'nizi gerekli olacak. Bu ayrıntıları Linkly içinden alabilirsiniz.

Trafik Raporları API'si

Linkly, trafik raporlarınız içinde sizin için otomatik olarak API istekleri oluşturur.

Linkly'nin trafik raporları sizin için otomatik olarak API istekleri oluşturur, ekranda gösterilen verilere dayanarak.

Bu bağlantılar API anahtarınızı içerir ve kendi uygulamalarınızda kolayca özelleştirilebilir ve kullanılabilir.

Çıkış formatları

Analytics API üç çıkış formatını destekler:

Pivot modu (matris formatı)

Varsayılan olarak, API her tarih için bir satır içeren zaman serileri verileri döndürür. Pivot modu ile tüm bağlantılarınızın trafiğini tek bir istekte matris olarak alabilirsiniz.

Herhangi bir trafik raporundaki Verileri Dışa Aktar açılır menüsünü kullanarak bağlantıya göre verileri hızla dışa aktarın veya API isteğinize pivot=link_id ekleyin.

İsteğinize pivot=link_id ekleyin:

• Satırlar olarak tarihler (günde bir satır)
• Sütunlar olarak bağlantılar (bağlantı başına bir sütun)

CSV/TSV pivot çıkış örneği

JSON pivot çıkış örneği

{
  "links": [
    {"id": 123, "name": "Bağlantım", "full_url": "https://linkly.link/abc"},
    {"id": 456, "name": "Diğer Bağlantı", "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}}
  ]
}

Pivot modu aşağıdakiler için yararlıdır:

• Birden fazla bağlantı arasında trafiği karşılaştırma
• Analiz için elektronik tablolara aktarma
• Tüm bağlantı verilerini tek bir çağrıda dashboard oluşturma

Ham tıklama verileri

Kayıtlı ham tıklama verileri, tam parametreler, zaman damgaları ve coğrafi konum bilgileri de dahil olmak üzere mevcuttur.

Bu verilere erişmek için alt kısımdaki sekmelerden Dışa Aktar'ı tıklayın ve formatınızı seçin. Bunlar uygulamanızda doğrudan kullanabileceğiniz tam biçimlendirilmiş API istekleridir.

Veri dışa aktarımı ile ilgili notlar

• Dışa aktarılan veri miktarını azaltmak için önce görünümdeki verileri filtrelemyi düşünün. Bu işlev, şu anda ekranda bulunan raporu oluşturmak için kullanılan temel verileri dışa aktarır.
• Bu veriler 3 saate kadar önbelleğe alınır. Bu uç noktaya tekrarlanan istekler gerçek zamanlı veriler üretmez.

Gruplandırılmış sayılar

/counters/{dimension} uç noktası, country, platform, destination, referer, isp veya link_id gibi tek bir boyuta göre gruplandırılmış tıklama toplamlarını döndürür. Sonuçlar tıklama sayısına göre sıralanır, en yüksek değer önce gelir.

Maksimum 10.000 değer döndürülür. Yüksek kardinalite boyutları — destination, referer, remote_ip ve isp — meşgul bir çalışma alanında bu kadar çok daha fazla farklı değerlere sahip olabilir. Böyle durumda, tıklama sayısına göre ilk 10.000'i alırsınız ve geri kalanı döndürülmez.

total alanı her zaman her grup genelinde (döndürülmeyen değerler dahil) toplam tıklamadır. Kesik sonuçta count değerleri total'dan daha az olacaktır — bu da count / total olarak hesaplanan yüzdenin hala doğru olduğu anlamına gelir.

İlk 10.000 yerine tam değer setine ihtiyacınız varsa, ham tıklama verilerini dışa aktarın ve bunu kendiniz toplayın veya BigQuery entegrasyonu kullanın.

Gerçek zamanlı tıklama bildirimleri

Gerçek zamanlı tıklama bildirimleri için Webhooklar bölümüne bakın. Webhooklar, bir tıklama gerçekleşir gerçekleşmez, tıklama hakkında detaylı bilgiler içeren belirtilen URL'lere POST isteği gönderir.

Ayrıca webhookları API aracılığıyla yönetebilirsiniz - ayrıntılar için OpenAPI spec belgesine bakın.

Adil kullanım ilkesi

Hız sınırları

Analytics API, çalışma alanı başına saat başına 50 istek ile hız sınırlanır.

Kullanım sınırları

Hız sınırlarına ek olarak, Analytics API her faturalandırma döneminde sıfırlanan kullanım sınırlarına sahiptir:

Kullanıma ne sayılır

• API İstekleri: Analytics API uç noktalarına (/clicks, /counters, /export) yapılan her çağrı bir istek olarak sayılır. API anahtarı ile yapılan Bağlantı dışa aktarmaları (/links/export) da bir istek olarak sayılır.
• Tarama Yapılan Veriler: İsteğinizi yerine getirmek için analitik veritabanımız tarafından işlenen veri miktarı. Daha büyük tarih aralıkları ve daha karmaşık sorgular daha fazla veri tarar.

Sınırları aştığınızda ne olur

Ücretli bir plandaki çalışma alanı tüm API isteklerini kullandığında, entegrasyonlarınızın çalışmasına devam etmesi için otomatik olarak API paketi aboneliğine eklenir ve çalışma alanının üyelerine bildirim için e-posta gönderilir. API paketi, bunu kaldırana kadar her faturalandırma döneminde ekstra API istekleri ekler.

API istekleri aşağıdaki durumlarda yerine 429 Too Many Requests hatası döndürür:

1. 1
   Çalışma alanı API paketleri ekleyemeyen Ücretsiz veya Başlangıç planında ise
2. 2
   Çalışma alanının aboneliği iptal edilmek üzere ayarlanmışsa veya ödeme vadesi geçmişse
3. 3
   Çalışma alanı tüm tarama yapılan veri ödenek sınırını kullanmışsa — API paketleri istekler ekler, veriler değil

Kullanım sınırları her faturalandırma döneminin başında sıfırlanır ve bağlantılarınız her halükarda normal olarak çalışmaya ve tıklama izlemeye devam eder.

Kullanımı azaltma ipuçları

Çoğu kullanıcı pivot modu (pivot=link_id) kullanarak tüm verilerini tek bir API istekte alabilir, bu da tüm bağlantıların trafiğini bir çağrıda matris olarak döndürür.

• Pivot modu kullanın: Her bağlantıyı ayrı ayrı sorgulamak yerine tüm bağlantılar için trafiği tek bir istekte almak için pivot=link_id ekleyin
• Yanıtları önbelleğe alın: Aynı verileri tekrar tekrar getirmek yerine API yanıtlarını yerel olarak saklayın
• Daha küçük tarih aralıkları kullanın: Yalnızca ihtiyacınız olan tarihleri sorgulayın
• İstekleri toplu işle: link_ids parametresini kullanarak birden fazla bağlantı sorgusunu tek bir istekte birleştirin

Daha fazlasına ihtiyacınız mı?

Faturalandırma sayfasındaki Add-ons bölümünde istediğiniz zaman kendiniz API paketleri ekleyebilirsiniz. Her paket her faturalandırma döneminde ekstra API istekleri ekler; sayfa onaylamadan önce planınız için fiyatı gösterir.

API paketleri hız sınırını değiştirmez. Daha yüksek bir hız sınırına ihtiyacınız varsa, lütfen destek widget'ını kullanarak bize konuşun.

BigQuery entegrasyonu

Yüksek hacimli analitik ihtiyaçları için Linkly, tıklama verilerinize doğrudan SQL erişimi sağlayan bir BigQuery entegrasyonu sunar.

• Canlı veri erişimi - BigQuery'de tıklama verilerinizi doğrudan gerçek zamanlı güncellemelerle sorgulayın
• Sınırsız sorgular - API hız sınırı yok; yalnızca BigQuery işlemi için ödeme yapıyorsunuz
• Özel raporlama - Looker, Data Studio veya Tableau ile dashboard oluşturun
• Veri birleştirme - Tıklama verilerini diğer iş metrikleriyle birleştirin

BigQuery entegrasyonu Kurumsal planda dahil edilmiştir. Ayrıntılar için bizimle iletişime geçin.

BigQuery Entegrasyonu hakkında daha fazla bilgi →

İlgili

• Link Kısaltma API'si - Bağlantıları programlı olarak oluşturun ve güncelleyin
• Webhooklar - Gerçek zamanlı tıklama bildirimleri
• BigQuery Entegrasyonu - Tıklama verilerine doğrudan SQL erişimi
• Zapier Entegrasyonu - Kodsuz entegrasyonlar