L’analyse a toujours été l’une des fonctionnalités les plus demandées pour l’API Kinsta, et elle est enfin disponible.
La première version des points de terminaison analytiques couvre la bande passante, les visites, la bande passante CDN et l’espace disque, ce qui permet aux développeurs, aux agences et aux outils d’automatisation de surveiller l’utilisation des ressources et de générer des rapports de manière programmatique.
Examinons ces points d’extrémité et leur fonctionnement.
Obtenir des données sur la bande passante du site
Le nouveau point de terminaison de bande passante vous permet de récupérer l’utilisation totale de la bande passante pour un site ou un environnement sur une période de temps spécifique.
Vous pouvez définir la période, par exemple 24_hours, 7_days, 30_days, 60_days, ou spécifier des dates exactes pour un rapport plus granulaire.
Par exemple, voici comment demander des données pour les sept derniers jours :
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 'Veillez à remplacer {env_id} et {company_id} par les identifiants de votre environnement et de votre entreprise.
Pour une plage de dates personnalisée, incluez les paramètres from et to au format 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 réponse comprend la bande passante totale et les ventilations quotidiennes sur la période choisie, ce qui vous permet de visualiser facilement les tendances ou d’intégrer les données dans des tableaux de bord.
{
"analytics": {
"analytics_response": {
"key": "bandwidth",
"data": [
{
"name": "bandwidth",
"total": 1000,
"dataset": [
{ "key": "2025-10-28T00:00:00", "value": "1000" }
]
}
]
}
}
}Vous trouverez toutes les options de paramètres et des exemples de requêtes dans la documentation de l’API pour l’analyse de la bande passante.
Obtenir des données sur les visites
Vous pouvez désormais obtenir le nombre total de visites et le nombre de visites par jour pour n’importe quel environnement, ce qui vous permet de suivre le trafic et l’activité des utilisateurs de manière programmatique. Comme pour la bande passante, vous pouvez définir des plages de temps ou des intervalles de dates spécifiques.
Exemple de requête :
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 'Exemple de réponse :
{
"analytics": {
"analytics_response": {
"key": "uniqueip",
"data": [
{
"name": "uniqueip",
"total": 1000,
"dataset": [
{ "key": "2025-10-28T00:00:00", "value": "1000" }
]
}
]
}
}
}Pour en savoir plus sur les champs et les filtres disponibles, consultez la documentation de l’API pour l’analyse des visites.
Obtenir l’utilisation de la bande passante du CDN
Si vous utilisez le CDN de Kinsta, vous pouvez désormais contrôler de manière programmatique la bande passante totale du CDN pour chaque environnement.
Le point de terminaison prend en charge des périodes de temps flexibles et des filtres de date, ce qui vous permet de mesurer le transfert de données CDN au fil du temps ou dans des fenêtres de rapport personnalisées.
Exemple de requête :
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 'Exemple de réponse :
{
"analytics": {
"analytics_response": {
"key": "cdn-bandwidth",
"data": [
{
"name": "cdn-bandwidth",
"total": 1000,
"dataset": [
{ "key": "2025-10-28T00:00:00", "value": "1000" }
]
}
]
}
}
}Vous trouverez les paramètres complets de la requête et des exemples de résultats dans la documentation de l’API pour l’analyse de la bande passante du CDN.
Obtenir l’utilisation de l’espace disque
Ce point de terminaison vous permet de vérifier l’utilisation totale de l’espace disque pour un environnement spécifique, y compris les tendances dans le temps. Il est particulièrement utile pour automatiser les contrôles de capacité, définir des alertes pour les seuils de stockage ou intégrer des données dans des tableaux de bord de surveillance.
Comme d’autres, vous pouvez effectuer des requêtes par identifiant de société, période, plage de dates et fuseau horaire pour générer des analyses précises de l’utilisation du disque.
Exemple de requête :
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 'Exemple de réponse :
{
"analytics": {
"analytics_response": {
"key": "diskSpaceUsage",
"data": [
{
"name": "diskSpaceUsage",
"total": 1000,
"dataset": [
{ "key": "2025-10-28T00:00:00", "value": "1000" }
]
}
]
}
}
}Consultez tous les paramètres et formats de réponse disponibles dans la documentation de l’API pour l’analyse de l’espace disque.
Intégrez l’analyse à vos propres outils
Ces nouveaux points de terminaison analytiques offrent aux développeurs une meilleure visibilité sur leurs environnements hébergés par Kinsta, directement à partir de leurs flux de travail d’automatisation et de création de rapports.
Que vous suiviez la bande passante, les visites ou l’espace disque, vous pouvez désormais intégrer les données de Kinsta dans vos tableaux de bord internes, vos plateformes d’analyse tierces ou vos systèmes de facturation personnalisés.
Vous trouverez tous les exemples de requêtes et les références des schémas dans la documentation de l’API Kinsta.