API Analytics di Linkly
Esporta dati di clic e rapporti sul traffico da Linkly in modo programmatico utilizzando la nostra API Analytics.
Correlato: API di accorciamento dei link | Webhook
Prima di iniziare
Linkly genera le richieste API nell'interfaccia affinché tu possa copiarle e incollarle nelle tue applicazioni.
Risparmia tempo e lascia che facciamo noi il lavoro. La nostra API è completamente leggibile da macchina.
Come iniziare con l'API Analytics
Apri qualsiasi rapporto sul traffico in Linkly.
Copia la richiesta API mostrata in alto nel rapporto.
Il formato di output dei dati è CSV. Questo link contiene la tua chiave API.
Questi link si trovano accanto a ogni tabella e grafico in Linkly.
Chiedi a ChatGPT o equivalente di adattare queste richieste in codice sorgente per la tua applicazione.
Non è necessario dedicare tempo a un'integrazione complessa.
Autorizzazione
Avrai bisogno della tua chiave API e ID Workspace. Puoi ottenere questi dettagli da Linkly.
Come trovare le tue credenziali API
Accedi a Linkly.
Fai clic su Impostazioni.
Fai clic su Chiavi API.
API dei rapporti sul traffico
Linkly genera automaticamente richieste API per te all'interno dei tuoi rapporti sul traffico.

I rapporti sul traffico di Linkly generano automaticamente richieste API per te, in base ai dati visualizzati sullo schermo.
Questi link includono la tua chiave API e sono facilmente personalizzabili e utilizzabili nelle tue applicazioni.
Formati di output
L'API Analytics supporta tre formati di output:
| Formato | Parametro | Descrizione |
|---|---|---|
| JSON | format=json (impostazione predefinita) | Dati strutturati per le applicazioni |
| CSV | format=csv | Valori separati da virgola per fogli di calcolo |
| TSV | format=tsv | Valori separati da tabulazioni, ideali per la visualizzazione nel browser e l'incollaggio nei fogli di calcolo |
Modalità pivot (formato matrice)
Per impostazione predefinita, l'API restituisce dati in serie temporali con una riga per data. Con la modalità pivot, puoi ottenere il traffico di tutti i tuoi link in una singola richiesta come matrice.
Utilizza il dropdown Esporta dati in qualsiasi rapporto sul traffico per esportare rapidamente i dati per link, oppure aggiungi pivot=link_id alla tua richiesta API.

Aggiungi pivot=link_id alla tua richiesta per ottenere dati con:
- Date come righe (una riga per giorno)
- Link come colonne (una colonna per link)
Esempio di output pivot CSV/TSV
| Mio link | Altro link | |
|---|---|---|
| name | Mio link | Altro link |
| full_url | https://linkly.link/abc | https://linkly.link/xyz |
| id | 123 | 456 |
| 2025-12-30 | 45 | 12 |
| 2025-12-31 | 52 | 8 |
| 2026-01-01 | 38 | 15 |
Esempio di output pivot JSON
{
"links": [
{"id": 123, "name": "Mio link", "full_url": "https://linkly.link/abc"},
{"id": 456, "name": "Altro 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}}
]
}
La modalità pivot è utile per:
- Confrontare il traffico tra più link
- Importare in fogli di calcolo per l'analisi
- Costruire dashboard con tutti i dati dei link in una sola chiamata
Dati di clic grezzi
I dati di clic grezzi che registriamo, inclusi parametri completi, timestamp e informazioni di geolocalizzazione, sono disponibili.
Per accedere a questi dati, fai clic su Esporta dalle schede in basso e scegli il tuo formato. Si tratta di richieste API completamente formate che puoi utilizzare direttamente nella tua applicazione.


Note sull'esportazione dei dati
- Considera di filtrare prima i dati nella visualizzazione per ridurre la quantità di dati esportati. Questa funzione esporta i dati sottostanti utilizzati per generare il rapporto attualmente sullo schermo.
- Questi dati sono memorizzati nella cache per un massimo di 3 ore. Le richieste ripetute a questo endpoint non produrranno dati in tempo reale.
Notifiche di clic in tempo reale
Per le notifiche di clic in tempo reale, consulta Webhook. I webhook inviano una richiesta POST all'URL specificato immediatamente quando si verifica un clic, con informazioni dettagliate sul clic.
Puoi anche gestire i webhook tramite l'API - consulta le specifiche OpenAPI per i dettagli.
Politica di uso corretto
Limiti di velocità
L'API Analytics è limitata a 50 richieste per ora per workspace.
Limiti di utilizzo
Oltre ai limiti di velocità, l'API Analytics ha limiti di utilizzo che si azzerano ogni periodo di fatturazione:
| Tipo di piano | Richieste API | Dati analizzati |
|---|---|---|
| Gratuito | 100/mese | 10 GB/mese |
| Pagato mensile | 2.000/mese | 2 TB/mese |
| Pagato annuale | 24.000/anno | 24 TB/anno |
| Mensile illimitato | 10.000/mese | 2 TB/mese |
| Annuale illimitato | 120.000/anno | 24 TB/anno |
Cosa conta come utilizzo
- Richieste API: Ogni chiamata agli endpoint dell'API Analytics (
/clicks,/counters,/export) conta come una richiesta. - Dati analizzati: La quantità di dati elaborati dal nostro database di analytics per soddisfare la tua richiesta. Gli intervalli di date più grandi e le query più complesse analizzano più dati.
Cosa accade quando superi i limiti
Se superi i tuoi limiti di utilizzo:
- 1Le richieste API restituiranno un errore
429 Too Many Requests - 2I tuoi limiti si azzereranno automaticamente all'inizio del prossimo periodo di fatturazione
- 3I tuoi link continueranno a funzionare e a tracciare i clic normalmente
Suggerimenti per ridurre l'utilizzo
La maggior parte degli utenti può ottenere tutti i loro dati in una singola richiesta API utilizzando la modalità pivot (pivot=link_id), che restituisce il traffico di tutti i link come matrice in una sola chiamata.
- Utilizza la modalità pivot: Aggiungi
pivot=link_idper ottenere il traffico per tutti i link in una singola richiesta invece di interrogare ogni link separatamente - Memorizza nella cache le risposte: Archivia le risposte API localmente invece di recuperare ripetutamente gli stessi dati
- Utilizza intervalli di date più piccoli: Interroga solo le date di cui hai bisogno
- Richieste batch: Combina più query di link in una singola richiesta utilizzando il parametro
link_ids
Hai bisogno di più?
Se hai bisogno di limiti più elevati, parlane con noi utilizzando il widget di supporto.
Integrazione BigQuery
Per le esigenze di analytics ad alto volume, Linkly offre un'integrazione BigQuery che fornisce accesso SQL diretto ai tuoi dati di clic.
- Accesso ai dati in tempo reale - Interroga i tuoi dati di clic direttamente in BigQuery con aggiornamenti in tempo reale
- Query illimitate - Nessun limite di velocità API; paghi solo per il calcolo di BigQuery
- Rapporti personalizzati - Crea dashboard con Looker, Data Studio o Tableau
- Consolidamento dei dati - Unisci i dati di clic con altre metriche aziendali
L'integrazione BigQuery è gratuita per i clienti del piano Unlimited, oppure disponibile come componente aggiuntivo di $100/mese per altri piani.
Scopri di più sull'integrazione BigQuery →
Correlato
- API di accorciamento dei link - Crea e aggiorna link in modo programmatico
- Webhook - Notifiche di clic in tempo reale
- Integrazione BigQuery - Accesso SQL diretto ai dati di clic
- Integrazione Zapier - Integrazioni senza codice
Monitora 500 clic mensili con tutte le funzioni incluse.
Nessuna carta di credito richiesta