Kinsta bietet bereits Analysedaten in MyKinsta an, aber mit unserem neuesten Update kannst du programmgesteuert über die Kinsta-API auf noch mehr dieser Daten zugreifen.

Dieses Update erweitert die Kinsta-API um fünf neue Analyse-Endpunkte, die die Top-Länder, Top-Städte, Top-Kunden-IPs, die Verteilung der Besuche und die Aufschlüsselung der Antwortcodes abdecken.

Das erleichtert es dir, Traffic- und Anfragedaten in deine eigenen Dashboards und Berichte zu integrieren – ähnlich wie bei früheren Versionen der Kinsta-Analytics-API, die darauf abzielten, Nutzungs- und Berichtsdaten in externe Tools zu übertragen.

Top-Länder und -Städte abrufen

Du kannst jetzt die Top-Länder und -Städte abrufen, aus denen der Traffic zu einer WordPress-Umgebung stammt.

Diese Endpunkte sind nützlich, um zu verstehen, woher die Besucher kommen, regionale Trends zu erkennen oder deine Traffic-Berichte zu ergänzen.

Hier ist eine Beispielanfrage für die Top-Länder:

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 '

Eine typische Antwort liefert eine Liste von Standorten und den dazugehörigen Aufrufen:

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

Der Endpunkt für die Top-Städte funktioniert genauso. Ersetze „top-countries“ in der URL durch „top-cities“, um stattdessen Daten auf Stadtebene abzurufen.

Weitere Informationen findest du in der API-Dokumentation zu den Top-Ländern und Top-Städten.

Top-Client-IPs identifizieren

Über den neuen Endpunkt „Top-Client-IPs“ kannst du sehen, welche Client-IP-Adressen in einer Umgebung den meisten Traffic generieren. Dies kann bei der Traffic-Analyse, der Fehlerbehebung bei ungewöhnlichen Spitzen oder dem Erkennen wiederkehrender Anfragequellen helfen.

Beispielanfrage:

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 '

Und so sieht die Antwort aus:

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

Weitere Details findest du in der API-Dokumentation zu den Top-Client-IPs.

Verteilung der Besuche über die Zeit prüfen

Du kannst auch Daten zur Besucherverteilung abrufen, die zeigen, wie sich der Traffic im Zeitverlauf nach Kategorien verteilt. Dies kann dir helfen, Muster im Besucherverhalten zu erkennen und zu verstehen, wie sich die Zusammensetzung des Traffics über einen ausgewählten Zeitraum verändert.

Beispielanfrage:

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 '

So sieht die Antwort aus:

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

Du kannst die verfügbaren Parameter in der API-Dokumentation zur Besucherverteilung nachlesen.

Aufschlüsselung der Antwortcodes anzeigen

Der Endpunkt zur Aufschlüsselung der Antwortcodes gibt dir einen besseren Überblick darüber, wie deine Umgebung im Laufe der Zeit auf Anfragen reagiert. Dies ist besonders nützlich, um im Rahmen der operativen Berichterstattung Trends bei erfolgreichen Antworten, Weiterleitungen oder Fehlern zu überwachen.

Beispielanfrage:

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 '

Beispielantwort:


{
  "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"
            }
          ]
        }
      ]
    }
  }
}

Die vollständigen Details zu Anfragen und Antworten findest du in der API-Dokumentation zur Aufschlüsselung der Antwortcodes.

Erweitere deine Analyse-Workflows

Diese neuen Endpunkte bauen auf den bereits in der Kinsta-API verfügbaren Analysefunktionen auf und bieten dir einen detaillierteren Einblick in Traffic-Quellen und Anfragemuster.

Egal, ob du Dashboards erstellst, Trends analysierst oder Anomalien untersuchst – du hast jetzt über die API mehr Datenpunkte zur Verfügung.

Alle Beispielanfragen und Schema-Referenzen findest du in der Kinsta-API-Referenz.