Kinsta offre già funzionalità di analisi in MyKinsta, ma con il nostro ultimo aggiornamento puoi accedere a un maggior numero di dati in modo programmatico tramite l’API di Kinsta.

Questo aggiornamento aggiunge cinque nuovi endpoint di analisi all’API di Kinsta, che coprono i paesi principali, le città principali, gli indirizzi IP dei client principali, la distribuzione delle visite e la ripartizione dei codici di risposta.

Ciò rende più facile importare i dati sul traffico e sulle richieste nelle tue dashboard e nei tuoi report, in modo simile alle versioni precedenti dell’API di analisi di Kinsta, che si concentravano sull’importazione dei dati di utilizzo e di reporting in strumenti esterni.

Ottieni i paesi e le città principali

Ora puoi recuperare i paesi e le città principali da cui proviene il traffico verso un ambiente WordPress.

Questi endpoint sono utili per capire da dove provengono i visitatori, identificare le tendenze regionali o arricchire i tuoi report sul traffico.

Ecco un esempio di richiesta per i paesi principali:

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

Una risposta tipica restituisce un elenco di località e le relative visualizzazioni:

{
 "analytics": {
   "analytics_response": {
     "key": "countries",
     "data": [
       {
         "name": "country",
         "views": "1000"
       }
     ]
   }
 }

L’endpoint delle città principali funziona allo stesso modo. Sostituisci top-countries con top-cities nell’URL per recuperare invece i dati a livello di città.

Puoi trovare ulteriori informazioni nella documentazione API relativa ai paesi principali e alle città principali.

Identifica i principali indirizzi IP client

Il nuovo endpoint top client IPs permette di vedere quali indirizzi IP dei client generano più traffico in un ambiente. Questo può aiutarti nell’analisi del traffico, nella risoluzione di picchi insoliti o nell’individuazione di fonti ricorrenti di richieste.

Richiesta di esempio:

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

Ecco come appare la risposta:

{
 "analytics": {
   "analytics_response": {
     "key": "topClientIPs",
     "data": [
       {
         "ip": "0.0.0.0",
         "value": "1000"
       }
     ]
   }
 }
}

Puoi trovare maggiori dettagli nella documentazione API relativa agli IP dei client principali.

Controlla la distribuzione delle visite nel tempo

Puoi anche recuperare i dati sulla dispersione delle visite, che mostrano come il traffico è distribuito nel tempo per categoria. Questo può aiutarti a capire i modelli di comportamento dei visitatori e come cambia la composizione del traffico in un periodo selezionato.

Richiesta di esempio:

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

Ecco come appare la risposta:

{
 "analytics": {
   "analytics_response": {
     "key": "userAgent",
     "data": [
       {
         "name": "mobile",
         "dataset": [
           {
             "date": "2025-11-08T00:00:00.000Z",
             "percent": "30.20"
           }
         ]
       }
     ]
   }
 }
}

Puoi esplorare i parametri disponibili nella documentazione dell’API per la dispersione delle visite.

Analisi dei codici di risposta

L’endpoint di analisi dei codici di risposta ti offre una visione più chiara di come il tuo ambiente risponde alle richieste nel tempo. Ciò è particolarmente utile per monitorare le tendenze relative a risposte riuscite, reindirizzamenti o errori nell’ambito della reportistica operativa.

Richiesta di esempio:

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

Risposta di esempio:

{
  "analytics": {
    "analytics_response": {
      "key": "responseCodes",
      "data": [
        {
          "response_code": "200",
          "data": [
            {
              "key": "2025-11-08T00:00:00.000Z",
              "value": "50"
            }
          ]
        },
        {
          "response_code": "404",
          "data": [
            {
              "key": "2025-11-08T00:00:00.000Z",
              "value": "5"
            }
          ]
        }
      ]
    }
  }
}

Puoi trovare i dettagli completi della richiesta e della risposta nella documentazione dell’API per l’analisi dei codici di risposta.

Potenzia i tuoi flussi di lavoro di analisi

Questi nuovi endpoint si basano sulle funzionalità di analisi già disponibili nell’API di Kinsta, offrendo una visione più dettagliata delle fonti di traffico e dei modelli di richiesta.

Che tu stia creando dashboard, analizzando le tendenze o indagando su anomalie, ora hai a disposizione più punti dati con cui lavorare tramite l’API.

Puoi trovare tutti gli esempi di richiesta e i riferimenti agli schemi nella guida di riferimento dell’API di Kinsta.