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-verzoeken in de interface voor u om in uw applicaties te kopiëren en 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 verkrijgen in Linkly.

Verkeersrapporten API

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

Linkly's verkeersrapporten 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 aan te passen en bruikbaar in uw eigen applicaties.

Uitvoerformaten

De Analytics API ondersteunt drie uitvoerformaten:

Pivot-modus (matrixformaat)

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 een 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)

Voorbeeld van CSV/TSV pivot-uitvoer

Voorbeeld van JSON pivot-uitvoer

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

• Het vergelijken van verkeer over meerdere koppelingen
• Importeren in spreadsheets voor analyse
• Dashboards bouwen met alle koppelingsgegevens in één aanroep

Onbewerkte klikgegevens

De onbewerkte klikgegevens die we registreren, inclusief volledige parameters, timestamps en geolocatiegegevens, 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 vormgegeven API-verzoeken die u rechtstreeks in uw toepassing kunt gebruiken.

Opmerkingen over gegevensexport

• Overweeg eerst gegevens 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 de cache opgeslagen. Herhaalde verzoeken aan dit eindpunt produceren geen realtime-gegevens.

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-spec voor details.

Fair use beleid

Snelheidsbeperkingen

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

Gebruikslimieten

Naast snelheidsbeperkingen heeft de Analytics API gebruikslimieten 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 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 koppelingen werken gewoon door en registreren klikken normaal

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 koppelingen in één aanroep als matrix retourneert.

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

Hebt u meer nodig?

Als u hogere limieten nodig hebt, kunt u via de ondersteuningswidget contact met ons opnemen.

BigQuery-integratie

Voor veel analytics-behoeften biedt Linkly een BigQuery-integratie die directe SQL-toegang tot uw klikgegevens biedt.

• Toegang tot live gegevens - Voer query's uit op uw klikgegevens rechtstreeks in BigQuery met realtime updates
• Onbeperkte query's - Geen API-snelheidsbeperkingen; u betaalt alleen voor BigQuery-berekening
• Aangepaste rapportage - Bouw dashboards met Looker, Data Studio of Tableau
• Gegevensconsolidatie - Voeg klikgegevens samen met andere bedrijfsmetrieken

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

Meer informatie over BigQuery-integratie →

Gerelateerd

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