Linkly's Analytics API

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

Gerelateerd: Link Shortening API | Webhooks

Voordat u begint

Linkly genereert API-aanvragen in de interface zodat u deze kunt kopiëren en in uw toepassingen kunt plakken.

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 gegevens uit Linkly halen.

Verkeersrapporten API

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

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

Deze links bevatten uw API-sleutel en zijn eenvoudig aanpasbaar en bruikbaar in uw eigen toepassingen.

Uitvoerformaten

De Analytics API ondersteunt drie uitvoerformaten:

Pivot-modus (matrixindeling)

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

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

Voeg pivot=link_id toe aan uw aanvraag om gegevens met het volgende op te halen:

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

CSV/TSV pivot-uitvoervoorbeeld

JSON pivot-uitvoervoorbeeld

{
  "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:

• Verkeer vergelijken tussen meerdere links
• Importeren in spreadsheets voor analyse
• Dashboards bouwen met alle linkgegevens in één aanroep

Ruwe klikgegevens

De ruwe klikgegevens die we registreren, inclusief volledige parameters, timestamps en geolocatie-informatie, zijn beschikbaar.

Om toegang te krijgen tot deze gegevens, klikt u op Exporteren op de tabbladen onderaan en kiest u uw formaat. Dit zijn volledig gevormde API-aanvragen die u rechtstreeks in uw toepassing kunt gebruiken.

Opmerkingen met betrekking tot gegevensexport

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

Gegroepeerde tellingen

Het eindpunt /counters/{dimension} retourneert klikken totaal gegroepeerd op één dimensie — zoals country, platform, destination, referer, isp of link_id. Resultaten worden in aflopende volgorde op aantal klikken geretourneerd.

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 werkruimte. In dat geval ontvangt u de top 10.000 op aantal klikken en de rest wordt niet geretourneerd.

Het veld total is altijd het totale aantal klikken voor elke groep, inclusief alle niet-geretourneerde groepen. Dus bij een afgekapt resultaat tellen de count-waarden op tot minder dan total — wat betekent dat een percentage berekend als count / total 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 voegt u ze zelf samen, of gebruikt u de BigQuery-integratie.

Real-time klikmeldingen

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

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

Fair-use-beleid

Snelheidslimieten

De Analytics API is beperkt tot 50 aanvragen per uur per werkruimte.

Gebruikslimieten

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

Wat telt als gebruik

• API-aanvragen: Elk aanroep naar de Analytics API-eindpunten (/clicks, /counters, /export) telt als één aanvraag. Link-exports (/links/export) gemaakt met een API-sleutel tellen ook als één aanvraag.
• Gescande gegevens: De hoeveelheid gegevens die door onze analyticsdatabase wordt verwerkt om aan uw aanvraag te voldoen. Grotere datumbereiken en complexere query's scannen meer gegevens.

Wat gebeurt er als u limieten overschrijdt

Wanneer een werkruimte met een betaald plan alle API-aanvragen heeft gebruikt, voegen we automatisch een API-pakket aan het abonnement toe, zodat uw integraties blijven werken, en sturen we een e-mail naar de leden van de werkruimte om hen ervan op de hoogte te stellen. Een API-pakket voegt elke factureringsperiode extra API-aanvragen toe totdat u het verwijdert.

API-aanvragen retourneren in plaats daarvan een fout 429 Too Many Requests wanneer:

1. 1
   De werkruimte bevindt zich op het Gratis- of Starter-plan, wat geen API-pakketten kan toevoegen
2. 2
   Het abonnement van de werkruimte is ingesteld om te worden geannuleerd of een betaling is achterstallig
3. 3
   De werkruimte heeft al zijn gescande gegevenslimiet gebruikt — API-pakketten voegen aanvragen toe, geen gegevens

Gebruikslimieten worden aan het begin van elke factureringsperiode opnieuw ingesteld, en uw links blijven sowieso normaal werken en klikken volgen.

Tips om het gebruik te verminderen

De meeste gebruikers kunnen al hun gegevens in één API-aanvraag krijgen met behulp van pivot-modus (pivot=link_id), die al het linkverkeer als matrix in één aanroep retourneert.

• Gebruik pivot-modus: Voeg pivot=link_id toe om verkeer voor alle links in één aanvraag op te halen in plaats van elke link afzonderlijk op te vragen
• Reacties in cache opslaan: Sla API-reacties lokaal op in plaats van dezelfde gegevens herhaaldelijk op te halen
• Gebruik kleinere datumbereiken: Query alleen de datums die u nodig hebt
• Batchaanvragen: Combineer meerdere linkquery's in één aanvraag met behulp van de parameter link_ids

Hebt u meer nodig?

U kunt op elk moment zelf API-pakketten toevoegen onder Add-ons op de pagina Facturering. Elk pakket voegt elke factureringsperiode extra API-aanvragen toe; op de pagina ziet u de prijs voor uw plan voordat u bevestigt.

API-pakketten veranderen de snelheidslimiet niet. Als u een hogere snelheidslimiet nodig hebt, kunt u contact met ons opnemen via de ondersteuningswidget.

BigQuery-integratie

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

• Live-gegevenstoegang - Vraag uw klikgegevens rechtstreeks in BigQuery op met real-time updates
• Onbeperkte query's - Geen API-snelheidslimieten; u betaalt alleen voor BigQuery-berekening
• Aangepaste rapportage - Bouw dashboards met Looker, Data Studio of Tableau
• Gegevensconsolidatie - Combineer klikgegevens met andere bedrijfsgegevens

BigQuery-integratie is inbegrepen in het Enterprise-plan. Neem contact met ons op voor meer informatie.

Meer informatie over BigQuery-integratie →

Gerelateerd

• Link Shortening API - Maak en werk links programmatisch bij
• Webhooks - Real-time klikmeldingen
• BigQuery-integratie - Directe SQL-toegang tot klikgegevens
• Zapier-integratie - Integraties zonder code