Analytics API van Linkly

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

Verwant: Link Shortening API | Webhooks

Voordat u begint

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

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

Autorisatie

U hebt uw API-sleutel en Workspace ID nodig. U kunt deze gegevens ophalen vanuit Linkly.

Traffic reports API

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

De verkeersrapporten van Linkly genereren 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 aanpasbaar en bruikbaar in uw eigen toepassingen.

Uitvoerformaten

De Analytics API ondersteunt drie uitvoerformaten:

Pivot-modus (matrixindeling)

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

Gebruik de Gegevens exporteren vervolgkeuzelijst in elk verkeersrapport om snel gegevens per koppeling 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)
• Koppelingen als kolommen (één kolom per koppeling)

CSV/TSV pivot-uitvoervoorbeeld

JSON pivot-uitvoervoorbeeld

{
  "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}}
  ]
}

Pivot-modus is nuttig voor:

• Vergelijken van verkeer over meerdere koppelingen
• Importeren in spreadsheets voor analyse
• Bouwen van dashboards met alle koppelingsgegevens in één aanroep

Ruwe klikgegevens

De ruwe klikgegevens die we registreren, inclusief volledige parameters, timestamps en geolocatiegegevens, zijn beschikbaar.

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

Opmerkingen over gegevensexport

• Overweeg om 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 rapport op het scherm te genereren.
• Deze gegevens worden tot 3 uur in cache opgeslagen. Herhaalde verzoeken aan dit eindpunt leveren geen realtime-gegevens op.

Realtime klikmeldingen

Voor realtime klikmeldingen raadpleegt u Webhooks. Webhooks sturen onmiddellijk wanneer een klik plaatsvindt een POST-verzoek naar uw 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

Snelheidsbeperkingen

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

Gebruiksbeperkingen

Naast snelheidsbeperkingen heeft de Analytics API gebruiksbeperkingen die elke factureringsperiode opnieuw worden ingesteld:

Wat telt als gebruik

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

Wat gebeurt er als u uw limiet overschrijdt

Als u uw gebruiksbeperkingen 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 koppelingen blijven normaal werken en klikken volgen

Tips om gebruik te verminderen

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

• Gebruik pivot-modus: Voeg pivot=link_id toe om verkeer voor alle koppelingen in één verzoek op te halen in plaats van elk koppeling afzonderlijk te doorzoeken
• Cache-antwoorden: Sla API-antwoorden lokaal op in plaats van dezelfde gegevens herhaaldelijk op te halen
• Gebruik kleinere datumbereiken: Vraag alleen de datums op die u nodig hebt
• Batch-verzoeken: Combineer meerdere koppelingsquery's in één verzoek met behulp van de link_ids-parameter

Heeft u meer nodig?

Neem contact met ons op via het ondersteuningswidget als u hogere limieten nodig hebt.

BigQuery-integratie

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

• Toegang tot live-gegevens - Query uw klikgegevens rechtstreeks in BigQuery met realtime-updates
• Onbeperkte query's - Geen API-snelheidsbeperkingen; u betaalt alleen voor BigQuery-berekeningen
• Aangepaste rapportage - Maak dashboards met Looker, Data Studio of Tableau
• Gegevensconsolidatie - Koppel klikgegevens aan andere bedrijfsstatistieken

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

Meer informatie over BigQuery-integratie →

Verwant

• Link Shortening API - Maak en werk koppelingen programmatisch bij
• Webhooks - Realtime klikmeldingen
• BigQuery-integratie - Directe SQL-toegang tot klikgegevens
• Zapier-integratie - No-code-integraties