Linkly's Analytics API

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

Gerelateerd: Link Shortening API | Webhooks

Voordat je begint

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

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

Hoe te beginnen met de Analytics API

1

Open een willekeurig verkeersrapport in Linkly.

2

Kopieer het API-verzoek dat bovenaan het rapport wordt weergegeven.

Je kunt kiezen voor CSV of JSON. Deze link bevat je API-sleutel.

Deze links staan naast elke tabel en grafiek in Linkly.

Kopieer het API-verzoek dat bovenaan het rapport wordt weergegeven.
Kopieer het API-verzoek dat bovenaan het rapport wordt weergegeven.
3

Vraag ChatGPT of een equivalent om deze verzoeken aan te passen naar broncode voor je applicatie.

Het is niet nodig om tijd te besteden aan een complexe integratie.

Autorisatie

Je hebt je API-sleutel en Workspace-ID nodig. Je kunt deze gegevens ophalen vanuit Linkly.

Hoe vind je je API-referenties

1

Log in op Linkly.

2

Klik op Instellingen.

3

Klik op API-sleutels.

Verkeersrapporten API

Linkly produceert automatisch API-verzoeken voor je binnen je verkeersrapporten.

Linkly's Traffic Reports API
Linkly's Traffic Reports API

Linkly's verkeersrapporten bouwen automatisch API-verzoeken voor je, gebaseerd op de gegevens die op het scherm worden weergegeven.

Deze links bevatten je API-sleutel en zijn gemakkelijk aanpasbaar en bruikbaar in je eigen applicaties.

Uitvoerformaten

De Analytics API ondersteunt drie uitvoerformaten:

FormaatParameterBeschrijving
JSONformat=json (standaard)Gestructureerde gegevens voor applicaties
CSVformat=csvKommagescheiden waarden voor spreadsheets
TSVformat=tsvTabgescheiden waarden, ideaal voor browserweergave en plakken in spreadsheets

Pivotmodus (Matrixformaat)

Standaard retourneert de API tijdreeksgegevens met één rij per datum. Met pivotmodus kun je al het verkeer van je links in één verzoek krijgen als een matrix.

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

Export Data dropdown
Export Data dropdown

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

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

CSV/TSV Pivot Uitvoervoorbeeld

Mijn LinkAndere Link
nameMijn LinkAndere Link
full_urlhttps://linkly.link/abchttps://linkly.link/xyz
id123456
2025-12-304512
2025-12-31528
2026-01-013815

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

Pivotmodus is nuttig voor:

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

Ruwe klikgegevens

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

Om toegang te krijgen tot deze gegevens, klik je op Exporteren in de tabbladen onderaan en kies je je formaat. Dit zijn volledig gevormde API-verzoeken die je direct in je applicatie kunt gebruiken.

Export Raw Data
Export Raw Data
Raw Click Data Example
Raw Click Data Example

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 dat momenteel op het scherm wordt weergegeven te genereren.
  • Deze gegevens worden maximaal 3 uur in de cache opgeslagen. Herhaalde verzoeken naar dit eindpunt leveren geen realtime gegevens op.

Realtime klikmeldingen

Voor realtime klikmeldingen, zie Webhooks. Webhooks sturen een POST-verzoek naar je opgegeven URL('s) direct wanneer een klik plaatsvindt, met gedetailleerde informatie over de klik.

Je kunt webhooks ook beheren via de API - zie de OpenAPI spec voor details.

Fair Use-beleid

Tarieflimieten

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

Gebruikslimieten

Naast tarieflimieten heeft de Analytics API gebruikslimieten die elke factureringsperiode worden gereset:

PlantypeAPI-verzoekenGescande gegevens
Gratis100/maand10 GB/maand
Betaald Maandelijks2.000/maand2 TB/maand
Betaald Jaarlijks24.000/jaar24 TB/jaar
Onbeperkt Maandelijks10.000/maand2 TB/maand
Onbeperkt Jaarlijks120.000/jaar24 TB/jaar

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 wordt verwerkt door onze analytics-database om je verzoek te vervullen. Grotere datumbereiken en complexere queries scannen meer gegevens.

Wat gebeurt er als je de limieten overschrijdt

Als je je gebruikslimieten overschrijdt:

  1. 1API-verzoeken retourneren een 429 Too Many Requests-fout
  2. 2Je limieten worden automatisch gereset aan het begin van je volgende factureringsperiode
  3. 3Je links blijven normaal werken en klikken bijhouden

Tips om gebruik te verminderen

De meeste gebruikers kunnen al hun gegevens krijgen in één enkel API-verzoek met behulp van pivotmodus (pivot=link_id), die al het verkeer van links als een matrix retourneert in één aanroep.

  • Gebruik pivotmodus: Voeg pivot=link_id toe om verkeer voor alle links in één verzoek te krijgen in plaats van elke link afzonderlijk op te vragen
  • Cache responses: Sla API-responses lokaal op in plaats van dezelfde gegevens herhaaldelijk op te halen
  • Gebruik kleinere datumbereiken: Vraag alleen de data op die je nodig hebt
  • Batch verzoeken: Combineer meerdere linkquery's in één verzoek met behulp van de link_ids-parameter

Meer nodig?

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

BigQuery-integratie

Voor analytische behoeften met groot volume biedt Linkly een BigQuery-integratie die directe SQL-toegang tot je klikgegevens biedt.

  • Live gegevenstoegang - Vraag je klikgegevens direct op in BigQuery met realtime updates
  • Onbeperkte queries - Geen API-tarieflimieten; je betaalt alleen voor BigQuery-rekenkracht
  • Aangepaste rapportage - Bouw dashboards met Looker, Data Studio of Tableau
  • Gegevensconsolidatie - Voeg klikgegevens samen met andere bedrijfsstatistieken

BigQuery-integratie is gratis voor Unlimited-planklanten, of beschikbaar als een add-on van €100/maand voor andere plannen.

Meer informatie over BigQuery-integratie →

Gerelateerd

Track 1000 monthly clicks with all features included.

No credit card required