API Analytics di Linkly

Esporta dati di clic e rapporti di traffico da Linkly a livello di programmazione utilizzando la nostra API Analytics.

Correlati: API Link Shortening | Webhook

Prima di iniziare

Linkly genera richieste API nell'interfaccia che puoi copiare e incollare nelle tue applicazioni.

Risparmia tempo e lascia che facciamo il lavoro difficile. La nostra API è completamente leggibile dalle macchine.

Autorizzazione

Avrai bisogno della tua Chiave API e dell'ID Workspace. Puoi ottenere questi dettagli dall'interno di Linkly.

API Rapporti di traffico

Linkly produce automaticamente richieste API per te all'interno dei tuoi rapporti di traffico.

I rapporti di traffico di Linkly costruiscono automaticamente richieste API per te, in base ai 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:

Modalità pivot (formato matrice)

Per impostazione predefinita, l'API restituisce dati in serie temporali con una riga per data. Con modalità pivot, puoi ottenere il traffico di tutti i tuoi link in una singola richiesta come matrice.

Utilizza il menu a discesa Esporta dati in qualsiasi rapporto di 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

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 su più link
• Importare in fogli di calcolo per l'analisi
• Creare dashboard con tutti i dati dei link in una singola 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 nella parte inferiore 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 il filtro dei dati nella vista in primo luogo 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.

Conteggi raggruppati

L'endpoint /counters/{dimension} restituisce i totali dei clic raggruppati per una singola dimensione, come country, platform, destination, referer, isp o link_id. I risultati vengono restituiti ordinati per conteggio dei clic, dal più alto al più basso.

Viene restituito un massimo di 10.000 valori. Le dimensioni con cardinalità elevata, destination, referer, remote_ip e isp, possono avere molti più valori distinti su uno spazio di lavoro occupato. Quando succede, ricevi i primi 10.000 per conteggio dei clic e il resto non viene restituito.

Il campo total è sempre il totale dei clic in ogni gruppo, inclusi quelli non restituiti. Quindi su un risultato troncato i valori di count si sommeranno a meno di total, il che significa che una percentuale calcolata come count / total è ancora accurata.

Se hai bisogno della serie completa di valori anziché dei primi 10.000, esporta i dati di clic grezzi e aggregali tu stesso, oppure utilizza l'integrazione BigQuery.

Notifiche di clic in tempo reale

Per le notifiche di clic in tempo reale, vedi 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 la specifica OpenAPI per i dettagli.

Politica di uso corretto

Limiti di velocità

L'API Analytics è limitata a 50 richieste all'ora per spazio di lavoro.

Limiti di utilizzo

Oltre ai limiti di velocità, l'API Analytics ha limiti di utilizzo che si ripristinano ogni periodo di fatturazione:

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:

1. 1
   Le richieste API restituiranno un errore 429 Too Many Requests
2. 2
   I tuoi limiti si ripristineranno automaticamente all'inizio del tuo prossimo periodo di fatturazione
3. 3
   I 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.

• Utilizza la modalità pivot: Aggiungi pivot=link_id per ottenere il traffico di tutti i link in una singola richiesta invece di interrogare ogni link separatamente
• Memorizza le risposte nella cache: Archivia le risposte dell'API localmente invece di recuperare gli stessi dati ripetutamente
• 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

Ne hai bisogno di più?

Se hai bisogno di limiti più elevati, contattaci 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 live - Interroga i tuoi dati di clic direttamente in BigQuery con aggiornamenti in tempo reale
• Query illimitati - Nessun limite di velocità API; paghi solo il calcolo BigQuery
• Reporting personalizzato - Crea dashboard con Looker, Data Studio o Tableau
• Consolidamento dei dati - Unisci i dati dei clic con altre metriche aziendali

L'integrazione BigQuery è inclusa nel piano Enterprise. Contattaci per i dettagli.

Scopri di più su BigQuery Integration →

Correlati

• API Link Shortening - Crea e aggiorna i link a livello di programmazione
• Webhook - Notifiche di clic in tempo reale
• Integrazione BigQuery - Accesso SQL diretto ai dati di clic
• Integrazione Zapier - Integrazioni senza codice