A Kinsta já fornece análises no MyKinsta, mas com a atualização mais recente, você pode acessar ainda mais desses dados de forma programática por meio da API da Kinsta.

Essa atualização adiciona cinco novos endpoints de analytics à API da Kinsta, cobrindo principais países, principais cidades, principais IPs de clientes, dispersão de visitas e distribuição de códigos de resposta.

Isso facilita a integração de dados de tráfego e solicitações para seus próprios painéis e relatórios, de forma semelhante às versões anteriores da API de análise da Kinsta, que focavam em levar dados de uso e relatórios para ferramentas externas.

Obter principais países e cidades

Agora você pode recuperar os principais países e cidades de onde vem o tráfego para um ambiente WordPress.

Esses endpoints são úteis para entender de onde vêm os visitantes, identificar tendências regionais ou enriquecer seus relatórios de tráfego.

Aqui está um exemplo de solicitação para os principais países:

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 '

Uma resposta típica retorna uma lista de locais e suas respectivas visualizações:

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

O endpoint das principais cidades funciona da mesma forma. Substitua top-countries por top-cities na URL para obter dados em nível de cidade.

Você pode saber mais na documentação da API sobre os principais países e principais cidades.

Identificar principais IPs de clientes

O novo endpoint de principais IPs de clientes permite ver quais endereços IP de clientes geram mais tráfego em um ambiente. Isso pode ajudar na análise de tráfego, na investigação de picos incomuns ou na identificação de fontes recorrentes de solicitações.

Exemplo de solicitação:

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 '

E esta é a resposta:

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

Você encontra mais detalhes na documentação da API sobre os principais IPs de clientes.

Verificar dispersão de visitas ao longo do tempo

Você também pode recuperar dados de dispersão de visitas, que mostram como o tráfego é distribuído ao longo do tempo por categoria. Isso ajuda a entender os padrões de comportamento dos visitantes e como a composição do tráfego varia ao longo do período selecionado.

Exemplo de solicitação:

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 '

Veja como fica a resposta:

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

Você pode explorar os parâmetros disponíveis na documentação da API para dispersão de visitas.

Analisar distribuição de códigos de resposta

O endpoint de detalhamento de códigos de resposta oferece uma visão mais clara de como seu ambiente responde às solicitações ao longo do tempo. Isso é especialmente útil para monitorar tendências em respostas bem-sucedidas, redirecionamentos ou erros como parte dos relatórios operacionais.

Exemplo de solicitação:

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 '

Exemplo de resposta:


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

Você pode encontrar todos os detalhes da solicitação e da resposta na documentação da API para ver a descrição dos códigos de resposta.

Aproveite seus fluxos de trabalho de análise

Esses novos endpoints se baseiam nos recursos de análise já disponíveis na API da Kinsta, oferecendo uma visão mais detalhada das fontes de tráfego e dos padrões de solicitação.

Seja para criar painéis, analisar tendências ou investigar anomalias, agora você tem mais dados adicionais para trabalhar por meio da API.

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