Las analíticas siempre ha sido una de las funcionalidades más solicitadas para la API de Kinsta, y por fin están aquí.

La primera versión de los endpoints de analíticas incluye ancho de banda, visitas, ancho de banda CDN y espacio en disco, lo que permite a los desarrolladores, agencias y herramientas de automatización monitorizar el uso de los recursos y generar informes mediante programación.

Examinemos estos endpoints y cómo funcionan.

Obtener datos de ancho de banda del sitio

El nuevo endpoint de ancho de banda te permite recuperar el uso total de ancho de banda de un sitio o entorno en un intervalo de tiempo específico.

Puedes definir el intervalo de tiempo, como 24_hours, 7_days, 30_days, 60_days, o especificar fechas exactas para obtener informes más detallados.

Por ejemplo, así es como se solicitan los datos de los últimos siete días:

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 '

Asegúrate de sustituir {env_id} y {company_id} por los ID reales de tu entorno y empresa.

Para un intervalo de fechas personalizado, incluye los parámetros from y to en el 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 respuesta incluye el ancho de banda total y los desgloses diarios durante el período elegido, para que puedas visualizar fácilmente las tendencias o integrar los datos en los paneles de control.

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

Encontrarás todas las opciones de parámetros y consultas de ejemplo en la documentación de la API para el análisis del ancho de banda.

Obtener datos de visitas

Ahora puedes obtener el recuento total y diario de visitas para cualquier entorno, lo que te permite realizar un seguimiento del tráfico y la actividad de los usuarios mediante programación. Al igual que con el ancho de banda, puedes definir intervalos de tiempo o intervalos de fechas específicos.

Ejemplo de solicitud:

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 '

Ejemplo de respuesta:

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

Más información sobre los campos y filtros disponibles en la documentación de la API para las analíticas de visitas.

Obtén el uso del ancho de banda de la CDN

Si utilizas la CDN de Kinsta, ahora puedes controlar mediante programación el ancho de banda total de la CDN para cada entorno.

El endpoint admite intervalos de tiempo flexibles y filtros de fecha, lo que te permite medir la transferencia de datos CDN a lo largo del tiempo o dentro de ventanas de informes personalizadas.

Ejemplo de solicitud:

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 '

Ejemplo de respuesta:

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

Puedes encontrar los parámetros de consulta completos y ejemplos de resultados en la documentación de la API para las analíticas de ancho de banda de CDN.

Obtener el uso del espacio en disco

Este endpoint te permite comprobar el uso total del espacio en disco para un entorno específico, incluidas las tendencias a lo largo del tiempo. Resulta especialmente útil para automatizar comprobaciones de capacidad, configurar alertas para umbrales de almacenamiento o integrar datos en paneles de control.

Al igual que otros, puedes consultar por ID de empresa, intervalo de tiempo, rango de fechas y zona horaria para generar analíticas precisas del uso del disco.

Ejemplo de consulta:

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 '

Ejemplo de respuesta:

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

Consulta todos los parámetros y formatos de respuesta disponibles en la documentación de la API para las analíticas de espacio en disco.

Incorpora analíticas a tus propias herramientas

Estos nuevos endpoints de analíticas ofrecen a los desarrolladores más visibilidad de sus entornos alojados en Kinsta directamente desde sus flujos de trabajo de automatización e informes.

Tanto si controlas el ancho de banda, las visitas o el espacio en disco, ahora puedes integrar los datos de Kinsta en tus paneles internos, plataformas de analíticas de terceros o sistemas de facturación personalizados.

Puedes encontrar todos los ejemplos de solicitudes y referencias de esquemas en la documentación de la API de Kinsta.