Análises sempre foi um dos recursos mais solicitados para a API da Kinsta, e finalmente chegou.

O primeiro lançamento de endpoints de análises cobre largura de banda, visitas, largura de banda de CDN e espaço em disco, permitindo que desenvolvedores, agências e ferramentas de automação monitorem o uso de recursos e gerem relatórios programaticamente.

Vamos examinar esses endpoints e como eles funcionam.

Obter dados de largura de banda do site

O novo endpoint de largura de banda permite recuperar o uso total de largura de banda para um site ou ambiente em um intervalo de tempo específico.

Você pode definir o intervalo de tempo, como 24_hours, 7_days, 30_days, 60_days, ou especificar datas exatas para obter relatórios mais detalhados.

Por exemplo, veja como solicitar dados dos últimos sete dias:

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 '

Certifique-se de substituir {env_id} e {company_id} pelos seus IDs reais de ambiente e empresa.

Para um intervalo de datas personalizado, inclua os parâmetros from e to no 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 '

A resposta inclui a largura de banda total e detalhamentos diários durante o período escolhido, para que você possa visualizar tendências facilmente ou integrar os dados em painéis.

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

Você pode encontrar todas as opções de parâmetros e exemplos de consultas na documentação da API para análise de largura de banda.

Obter dados de visitas

Agora você pode obter contagens de visitas totais e por dia para qualquer ambiente, permitindo que você rastreie o tráfego e a atividade do usuário de forma programática. Assim como na largura de banda, você pode definir intervalos de tempo ou intervalos de datas específicos.

Exemplo de solicitação:

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 '

Exemplo de resposta:

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

Saiba mais sobre os campos e filtros disponíveis na documentação da API para análise de visitas.

Obter uso de largura de banda do CDN

Se você estiver usando o CDN da Kinsta, agora pode monitorar programaticamente a largura de banda total do CDN para cada ambiente.

O endpoint suporta intervalos de tempo flexíveis e filtros de data, permitindo medir a transferência de dados do CDN ao longo do tempo ou dentro de janelas de relatórios personalizadas.

Exemplo de solicitação:

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 '

Exemplo de resposta:

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

Você pode encontrar parâmetros de consulta completos e exemplos de saída na documentação da API para análise de largura de banda do CDN.

Obter uso de espaço em disco

Este endpoint permite verificar o uso total de espaço em disco para um ambiente específico, incluindo tendências ao longo do tempo. É especialmente útil para automatizar verificações de capacidade, definir alertas para limites de armazenamento ou integrar dados em painéis de monitoramento.

Assim como os outros, você pode consultar por ID da empresa, intervalo de tempo, intervalo de datas e fuso horário para gerar análises precisas de uso de disco.

Exemplo de solicitação:

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 '

Exemplo de resposta:

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

Veja todos os parâmetros e formatos de resposta disponíveis na documentação da API para análise de espaço em disco.

Incorpore análises em suas próprias ferramentas

Esses novos endpoints de análises dão aos desenvolvedores mais visibilidade sobre seus ambientes hospedados na Kinsta diretamente de seus fluxos de trabalho de automação e relatórios.

Esteja você rastreando largura de banda, visitas ou espaço em disco, agora você pode integrar dados da Kinsta em seus painéis internos, plataformas de análise de terceiros ou sistemas de cobrança personalizados.

Você pode encontrar todos os exemplos de solicitação e referências de esquema na documentação da API da Kinsta.