Accédez à davantage d’informations sur le trafic et les interactions grâce à l’API Kinsta

Kinsta propose déjà des statistiques dans MyKinsta, mais grâce à notre dernière mise à jour, vous pouvez désormais accéder à davantage de données par programmation via l’API Kinsta.

Cette mise à jour ajoute cinq nouveaux points de terminaison d’analyse à l’API Kinsta, couvrant les principaux pays, les principales villes, les principales adresses IP des clients, la répartition des visites et la répartition des codes de réponse.

Cela facilite l’extraction des données de trafic et de requêtes vers vos propres tableaux de bord et rapports, à l’instar des versions précédentes de l’API d’analyse de Kinsta, qui visaient à intégrer les données d’utilisation et de reporting dans des outils externes.

Obtenir les principaux pays et villes

Vous pouvez désormais récupérer les principaux pays et villes à l’origine du trafic vers un environnement WordPress.

Ces points de terminaison sont utiles pour comprendre d’où viennent les visiteurs, identifier les tendances régionales ou enrichir vos rapports de trafic.

Voici un exemple de requête pour les principaux pays :

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 '

Une réponse type renvoie une liste de lieux et leurs vues associées :

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

Le point de terminaison « top-cities » fonctionne de la même manière. Remplace « top-countries » par « top-cities » dans l’URL pour récupérer des données au niveau des villes.

Vous pouvez en savoir plus dans la documentation de l’API pour les pays les plus consultés et les villes les plus consultées.

Identifier les principales adresses IP des clients

Le nouveau point de terminaison « top-client-ips » vous permet de voir quelles adresses IP de clients génèrent le plus de trafic dans un environnement. Cela peut vous aider à analyser le trafic, à résoudre les pics inhabituels ou à repérer les sources de requêtes récurrentes.

Exemple de requête :

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 '

Et voici à quoi ressemble la réponse :

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

Vous trouverez plus de détails dans la documentation de l’API pour les adresses IP des principaux clients.

Vérifier la répartition des visites dans le temps

Vous pouvez également récupérer des données sur la répartition des visites, qui montrent comment le trafic est réparti dans le temps par catégorie. Cela peut vous aider à comprendre les tendances dans le comportement des visiteurs et comment la composition du trafic évolue sur une période donnée.

Exemple de requête :

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 '

Voici à quoi ressemble la réponse :

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

Vous pouvez découvrir les réglages disponibles dans la documentation de l’API pour la dispersion des visites.

Analyse de la répartition des codes de réponse

Le point de terminaison de répartition des codes de réponse vous donne une vision plus claire de la façon dont votre environnement répond aux requêtes au fil du temps. Cela est particulièrement utile pour surveiller les tendances en matière de réponses réussies, de redirections ou d’erreurs dans le cadre du reporting opérationnel.

Exemple de requête :

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 '

Exemple de réponse :

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

Vous trouverez tous les détails des requêtes et des réponses dans la documentation de l’API pour connaître la signification des codes de réponse.

Améliorer vos workflows d’analyse

Ces nouveaux points de terminaison s’appuient sur les capacités d’analyse déjà disponibles dans l’API Kinsta, vous offrant une vue plus détaillée des sources de trafic et des modèles de requêtes.

Que vous créiez des tableaux de bord, que vous analysiez les tendances ou que vous enquêtiez sur des anomalies, vous disposez désormais de plus de points de données à exploiter via l’API.

Vous trouverez tous les exemples de requêtes et les références de schémas dans la documentation de l’API Kinsta.