Analytics API van Linkly

Exporteer klikgegevens en verkeersrapporten van Linkly programmatisch met behulp van onze Analytics API.

Gerelateerd: Link Shortening API | Webhooks

Voordat u begint

Linkly genereert API-verzoeken in de interface die u kunt kopiëren en plakken in uw applicaties.

Bespaar tijd en laat ons het zware werk doen. Onze API is volledig machine-consumable.

Autorisatie

U hebt uw API-sleutel en Workspace ID nodig. U kunt deze details in Linkly vinden.

Verkeersrapporten API

Linkly genereert automatisch API-verzoeken voor u in uw verkeersrapporten.

De verkeersrapporten van Linkly bouwen automatisch API-verzoeken voor u, op basis van de gegevens die op het scherm worden weergegeven.

Deze links bevatten uw API-sleutel en zijn gemakkelijk aan te passen en bruikbaar in uw eigen applicaties.

Uitvoerindelingen

De Analytics API ondersteunt drie uitvoerindelingen:

Pivot-modus (matrixindeling)

Standaard retourneert de API tijdreeksgegevens met één rij per datum. Met pivot-modus kunt u al het verkeer van uw links in één verzoek als matrix ophalen.

Gebruik het Gegevens exporteren vervolgkeuzemenu in een verkeersrapport om snel gegevens per link te exporteren, of voeg pivot=link_id toe aan uw API-verzoek.

Voeg pivot=link_id toe aan uw verzoek om gegevens te krijgen met:

• Datums als rijen (één rij per dag)
• Links als kolommen (één kolom per link)

Voorbeeld CSV/TSV pivot-uitvoer

Voorbeeld JSON pivot-uitvoer

{
  "links": [
    {"id": 123, "name": "Mijn link", "full_url": "https://linkly.link/abc"},
    {"id": 456, "name": "Andere 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}}
  ]
}

Pivot-modus is nuttig voor:

• Het vergelijken van verkeer over meerdere links
• Importeren in spreadsheets voor analyse
• Het bouwen van dashboards met alle linkgegevens in één aanroep

Ruwe klikgegevens

De ruwe klikgegevens die we registreren, inclusief alle parameters, tijdstempels en geolocatiegegevens, zijn beschikbaar.

Klik op Exporteren in de tabbladen onderaan en kies uw indeling om toegang tot deze gegevens te krijgen. Dit zijn volledig samengestelde API-verzoeken die u rechtstreeks in uw applicatie kunt gebruiken.

Opmerkingen over gegevensexport

• Overweeg om gegevens eerst in de weergave te filteren om de hoeveelheid gegevens die wordt geëxporteerd te verminderen. Deze functie exporteert de onderliggende gegevens die worden gebruikt om het rapport te genereren dat momenteel op het scherm wordt weergegeven.
• Deze gegevens worden tot 3 uur in de cache opgeslagen. Herhaalde verzoeken aan dit eindpunt leveren geen real-time gegevens op.

Gegroepte tellingen

Het /counters/{dimension} eindpunt retourneert klikaantallen gegroepeerd op één dimensie — zoals country, platform, destination, referer, isp of link_id. Resultaten worden geretourneerd gesorteerd op klikaantal, hoogste eerst.

Maximaal 10.000 waarden worden geretourneerd. Dimensies met hoge kardinaliteit — destination, referer, remote_ip en isp — kunnen veel meer afzonderlijke waarden hebben op een drukke workspace. In dat geval ontvangt u de top 10.000 op klikaantal en worden de rest niet geretourneerd.

Het total veld is altijd het totale aantal klikken in elke groep, inclusief alle groepen die niet worden geretourneerd. Op een afgekapt resultaat tellen de count waarden op tot minder dan total — wat betekent dat een percentage dat als count / total wordt berekend nog steeds nauwkeurig is.

Als u de volledige set waarden nodig hebt in plaats van de top 10.000, exporteert u de ruwe klikgegevens en aggregeert u deze zelf, of gebruikt u de BigQuery-integratie.

Real-time klikmeldingen

Zie Webhooks voor real-time klikmeldingen. Webhooks sturen onmiddellijk wanneer een klik plaatsvindt een POST-verzoek naar de opgegeven URL('s) met gedetailleerde informatie over de klik.

U kunt webhooks ook via de API beheren - zie de OpenAPI-specificatie voor details.

Fair use beleid

Snelheidslimieten

De Analytics API is beperkt tot 50 verzoeken per uur per workspace.

Gebruikslimieten

Naast snelheidslimieten heeft de Analytics API gebruikslimieten die elke factureringsperiode opnieuw worden ingesteld:

Wat telt als gebruik

• API-verzoeken: Elke oproep naar de Analytics API eindpunten (/clicks, /counters, /export) telt als één verzoek.
• Gescande gegevens: De hoeveelheid gegevens die door onze analyticsdatabase wordt verwerkt om uw verzoek in te vullen. Grotere datumbereiken en complexere query's scannen meer gegevens.

Wat gebeurt er als u uw limieten overschrijdt

Als u uw gebruikslimieten overschrijdt:

1. 1
   API-verzoeken retourneren een 429 Too Many Requests fout
2. 2
   Uw limieten worden automatisch opnieuw ingesteld aan het begin van uw volgende factureringsperiode
3. 3
   Uw links blijven normaal werken en klikken volgen

Tips om het gebruik te verminderen

De meeste gebruikers kunnen al hun gegevens in één API-verzoek ophalen met behulp van pivot-modus (pivot=link_id), die het verkeer van alle links als matrix in één oproep retourneert.

• Gebruik pivot-modus: Voeg pivot=link_id toe om verkeer voor alle links in één verzoek op te halen in plaats van elke link afzonderlijk te bevragen
• Cacheresponsen: Sla API-responsen lokaal op in plaats van herhaaldelijk dezelfde gegevens op te halen
• Gebruik kleinere datumbereiken: Bevraag alleen de datums die u nodig hebt
• Batchverzoeken: Combineer meerdere linkquery's in één verzoek met behulp van de link_ids parameter

Meer nodig?

Als u hogere limieten nodig hebt, neem dan contact met ons op via de ondersteuningswidget.

BigQuery-integratie

Voor analyticbehoeften met groot volume biedt Linkly een BigQuery-integratie die directe SQL-toegang tot uw klikgegevens biedt.

• Live gegevenstoegang - Bevraag uw klikgegevens rechtstreeks in BigQuery met real-time updates
• Onbeperkte query's - Geen API-snelheidslimieten; u betaalt alleen voor BigQuery-compute
• Aangepaste rapportage - Bouw dashboards met Looker, Data Studio of Tableau
• Gegevensconsolidatie - Voeg klikgegevens samen met andere bedrijfsmetrieken

BigQuery-integratie is inbegrepen bij het Enterprise-abonnement. Contact opnemen voor details.

Meer informatie over BigQuery-integratie →

Gerelateerd

• Link Shortening API - Maak en update links programmatisch
• Webhooks - Real-time klikmeldingen
• BigQuery-integratie - Directe SQL-toegang tot klikgegevens
• Zapier-integratie - No-code integraties