API Analytics di Linkly
Esporta dati sui clic e report sul traffico da Linkly in modo programmatico utilizzando la nostra API Analytics.
Correlati: API di Riduzione Link | Webhook
Prima di Iniziare
Linkly genera richieste API nell'interfaccia che puoi copiare e incollare nelle tue applicazioni.
Risparmia tempo e lascia che sia noi a fare il lavoro difficile. La nostra API è completamente utilizzabile da macchine.
Come Iniziare con l'API Analytics
Apri qualsiasi report sul traffico in Linkly.
Copia la richiesta API mostrata nella parte superiore del report.
Puoi scegliere CSV o JSON. Questo link contiene la tua chiave API.
Questi link sono accanto ad ogni tabella e grafico in Linkly.

Chiedi a ChatGPT o equivalente di adattare queste richieste in codice sorgente per la tua applicazione.
Non c'è bisogno di perdere tempo per fare un'integrazione complessa.
Autorizzazione
Avrai bisogno della tua Chiave API e del tuo ID Workspace. Puoi ottenere questi dettagli dall'interno di Linkly.
Come Trovare le Tue Credenziali API
Accedi a Linkly.
Clicca su Impostazioni.
Clicca su Chiavi API.
API Report sul Traffico
Linkly produce automaticamente richieste API per te all'interno dei tuoi report sul traffico.

I report sul traffico di Linkly creano automaticamente richieste API per te, basate sui dati mostrati 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 (predefinito) | Dati strutturati per applicazioni |
| CSV | format=csv | Valori separati da virgola per fogli di calcolo |
| TSV | format=tsv | Valori separati da tabulazione, ideali per la visualizzazione nel browser e per incollare in fogli di calcolo |
Modalità Pivot (Formato Matrice)
Per impostazione predefinita, l'API restituisce dati di 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.
Usa il menu a discesa Esporta Dati in qualsiasi report 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
| Il Mio Link | Altro Link | |
|---|---|---|
| name | Il 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": "Il 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 Grezzi sui Clic
I dati grezzi sui clic che registriamo, inclusi parametri completi, timestamp e informazioni di geolocalizzazione, sono disponibili.
Per accedere a questi dati, clicca su Esporta dalle schede in basso e scegli il tuo formato. Queste sono richieste API completamente formate che puoi utilizzare direttamente nella tua applicazione.


Note Riguardo l'Esportazione dei Dati
- Considera di filtrare prima i dati nella vista per ridurre la quantità di dati esportati. Questa funzione esporta i dati sottostanti utilizzati per generare il report attualmente sullo schermo.
- Questi dati sono memorizzati in cache fino a 3 ore. Richieste ripetute a questo endpoint non produrranno dati in tempo reale.
Notifiche di Clic in Tempo Reale
Per notifiche di clic in tempo reale, vedi Webhook. I webhook inviano una richiesta POST agli URL specificati immediatamente quando si verifica un clic, con informazioni dettagliate sul clic.
Puoi anche gestire i webhook tramite l'API - vedi le specifiche OpenAPI per i dettagli.
Politica di Uso Corretto
Limiti di Frequenza
L'API Analytics è limitata a 50 richieste all'ora per workspace.
Limiti di Utilizzo
Oltre ai limiti di frequenza, l'API Analytics ha limiti di utilizzo che si azzerano ad ogni periodo di fatturazione:
| Tipo di Piano | Richieste API | Dati Scansionati |
|---|---|---|
| Gratuito | 100/mese | 10 GB/mese |
| Pagamento Mensile | 2.000/mese | 2 TB/mese |
| Pagamento Annuale | 24.000/anno | 24 TB/anno |
| Illimitato Mensile | 10.000/mese | 2 TB/mese |
| Illimitato Annuale | 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 Scansionati: La quantità di dati elaborati dal nostro database di analytics per soddisfare la tua richiesta. Intervalli di date più ampi e query più complesse scansionano più dati.
Cosa Succede 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 tuo prossimo periodo di fatturazione
- 3I tuoi link continueranno a funzionare e tracciare i clic normalmente
Suggerimenti per Ridurre l'Utilizzo
La maggior parte degli utenti può ottenere tutti i propri 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.
- Usa la modalità pivot: Aggiungi
pivot=link_idper ottenere il traffico di tutti i link in una singola richiesta invece di interrogare ogni link separatamente - Memorizza le risposte in cache: Memorizza localmente le risposte API invece di recuperare ripetutamente gli stessi dati
- Usa intervalli di date più piccoli: Interroga solo le date di cui hai bisogno
- Raggruppa le richieste: Combina query di più link in una singola richiesta utilizzando il parametro
link_ids
Hai Bisogno di Più?
Se hai bisogno di limiti più elevati, contattaci utilizzando il widget di supporto.
Integrazione BigQuery
Per esigenze di analytics ad alto volume, Linkly offre un'integrazione BigQuery che fornisce accesso SQL diretto ai tuoi dati sui clic.
- Accesso ai dati in tempo reale - Interroga i tuoi dati sui clic direttamente in BigQuery con aggiornamenti in tempo reale
- Query illimitate - Nessun limite di frequenza API; paghi solo per il calcolo BigQuery
- Reporting personalizzato - Costruisci dashboard con Looker, Data Studio o Tableau
- Consolidamento dati - Unisci i dati sui clic con altre metriche aziendali
L'integrazione BigQuery è gratuita per i clienti del piano Illimitato, o disponibile come componente aggiuntivo da $100/mese per altri piani.
Scopri di più sull'Integrazione BigQuery →
Correlati
- API di Riduzione Link - Crea e aggiorna link in modo programmatico
- Webhook - Notifiche di clic in tempo reale
- Integrazione BigQuery - Accesso SQL diretto ai dati sui clic
- Integrazione Zapier - Integrazioni senza codice