Il recupero delle statistiche è sempre stato tra le funzioni più richieste per l’API di Kinsta e finalmente è arrivato.

La prima versione degli endpoint dei dati analitici riguarda la larghezza di banda, le visite, la larghezza di banda del CDN e lo spazio su disco, consentendo a sviluppatori, agenzie e strumenti di automazione di monitorare l’utilizzo delle risorse e generare report in modo programmatico.

Esaminiamo questi endpoint e il loro funzionamento.

Ottenere i dati sulla larghezza di banda del sito

Il nuovo endpoint per la larghezza di banda permette di recuperare l’utilizzo totale della larghezza di banda per un sito o un ambiente in un intervallo di tempo specifico.

È possibile definire l’intervallo di tempo, come ad esempio 24_hours, 7_days, 30_days, 60_days, o specificare le date esatte per un reporting più granulare.

Ad esempio, ecco come richiedere i dati relativi agli ultimi sette giorni:

curl -i -X GET \
  'https://api.kinsta.com/v2/sites/environments/{env_id}/analytics/bandwidth?company_id={company_id}&time_span=7_days' \
  -H 'Authorization: Bearer '

Assicurati di sostituire {env_id} e {company_id} con gli ID reali dell’ambiente e dell’azienda.

Per un intervallo di date personalizzato, includi i parametri from e to nel formato YYYY-MM-DD:

curl -i -X GET \
  'https://api.kinsta.com/v2/sites/environments/{env_id}/analytics/bandwidth?company_id={company_id}&from=2025-10-01&to=2025-10-15' \
  -H 'Authorization: Bearer '

La risposta include la larghezza di banda totale e la suddivisione giornaliera per il periodo scelto, in modo da poter visualizzare facilmente le tendenze o integrare i dati nella dashboard.

{
  "analytics": {
    "analytics_response": {
      "key": "bandwidth",
      "data": [
        {
          "name": "bandwidth",
          "total": 1000,
          "dataset": [
            { "key": "2025-10-28T00:00:00", "value": "1000" }
          ]
        }
      ]
    }
  }
}

Puoi trovare tutte le opzioni dei parametri e le query di esempio nella documentazione dell’API per l’analisi della larghezza di banda.

Ottenere i dati sulle visite

Ora puoi ottenere il conteggio delle visite totali e giornaliere per qualsiasi ambiente, e monitorare così il traffico e l’attività degli utenti in modo programmatico. Come per la larghezza di banda, puoi definire intervalli di tempo o date specifiche.

Esempio di richiesta:

curl -i -X GET \
  'https://api.kinsta.com/v2/sites/environments/{env_id}/analytics/visits?company_id={company_id}&time_span=30_days' \
  -H 'Authorization: Bearer '

Esempio di risposta:

{
  "analytics": {
    "analytics_response": {
      "key": "uniqueip",
      "data": [
        {
          "name": "uniqueip",
          "total": 1000,
          "dataset": [
            { "key": "2025-10-28T00:00:00", "value": "1000" }
          ]
        }
      ]
    }
  }
}

Per saperne di più sui campi e i filtri disponibili, consulta la documentazione API per l’analisi delle visite.

Ottieni l’utilizzo della larghezza di banda CDN

Se utilizzi il CDN di Kinsta, ora puoi monitorare in modo programmatico la larghezza di banda totale del CDN per ogni ambiente.

L’endpoint supporta intervalli di tempo flessibili e filtri di data, consentendoti di misurare il trasferimento dei dati CDN nel tempo o all’interno di finestre di reporting personalizzate.

Esempio di richiesta:

curl -i -X GET \
  'https://api.kinsta.com/v2/sites/environments/{env_id}/analytics/cdn-bandwidth?company_id={company_id}&time_span=30_days' \
  -H 'Authorization: Bearer '

Esempio di risposta:

{
  "analytics": {
    "analytics_response": {
      "key": "cdn-bandwidth",
      "data": [
        {
          "name": "cdn-bandwidth",
          "total": 1000,
          "dataset": [
            { "key": "2025-10-28T00:00:00", "value": "1000" }
          ]
        }
      ]
    }
  }
}

Puoi trovare i parametri di query completi e gli esempi di output nella documentazione API per l’analisi della larghezza di banda CDN.

Ottieni l’utilizzo dello spazio su disco

Questo endpoint permette di verificare l’utilizzo totale dello spazio su disco per un ambiente specifico, comprese le tendenze nel tempo. È particolarmente utile per automatizzare i controlli della capacità, impostare avvisi per le soglie di archiviazione o integrare i dati nelle dashboard di monitoraggio.

Come gli altri, puoi effettuare query per ID azienda, periodo di tempo, intervallo di date e fuso orario per generare analisi precise sull’utilizzo del disco.

Esempio di richiesta:

curl -i -X GET \
  'https://api.kinsta.com/v2/sites/environments/{env_id}/analytics/diskspace?company_id={company_id}&time_zone=02:00&time_span=30_days' \ 
  -H 'Authorization: Bearer '

Esempio di risposta:

{
  "analytics": {
    "analytics_response": {
      "key": "diskSpaceUsage",
      "data": [
        {
          "name": "diskSpaceUsage",
          "total": 1000,
          "dataset": [
            { "key": "2025-10-28T00:00:00", "value": "1000" }
          ]
        }
      ]
    }
  }
}

Vedi tutti i parametri e i formati di risposta disponibili nella documentazione API per l’analisi dello spazio su disco.

Aggiungi le statistiche al tuo toolkit

Questi nuovi endpoint di analisi offrono agli sviluppatori una maggiore visibilità sugli ambienti ospitati da Kinsta direttamente dai loro flussi di lavoro di automazione e reporting.

Che tu stia monitorando la larghezza di banda, le visite o lo spazio su disco, ora puoi integrare i dati di Kinsta nelle tue dashboard interne, nelle piattaforme di analisi di terze parti o nei sistemi di fatturazione personalizzati.

Puoi trovare tutti gli esempi di richiesta e i riferimenti allo schema nella documentazione dell’API di Kinsta.