> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Análise do website

> Obter análises de um website hospedado na Square Cloud. Há um limite de taxa de 1 requisição não-cached a cada 10 segundos.

<ParamField header="Authorization" type="string" placeholder="Chave da API" required>
  A chave da API para sua conta. Você pode encontrá-la nas [configurações da conta](https://squarecloud.app/pt-br/account/security).
</ParamField>

### Parâmetros

<ParamField path="app_id" type="string" placeholder="ID da Aplicação" required>
  O ID da aplicação. Você pode encontrá-lo na URL do painel da sua aplicação.
</ParamField>

<ParamField query="start" type="string" placeholder="Timestamp ISO 8601" required>
  Timestamp inicial em formato ISO 8601 para a janela de análise.
</ParamField>

<ParamField query="end" type="string" placeholder="Timestamp ISO 8601" required>
  Timestamp final em formato ISO 8601. Deve ser posterior ao `start`.
</ParamField>

### Resposta

<Info>
  Esta rota pode retornar uma resposta em formato compactado, otimizando a transmissão de dados.
</Info>

<ResponseField name="status" type="string">
  Indica se a chamada foi bem-sucedida. `success` se bem-sucedida, `error` se não.
</ResponseField>

<ResponseField name="response" type="object">
  Consulte o Exemplo de Resposta no lado direito para ver a resposta completa.
</ResponseField>

<ResponseExample>
  ```json theme={null}
  {
    "status": "success",
    "response": {
      "visits": [
        {
          "visits": 1,
          "requests": 4,
          "bytes": 9677,
          "date": "2025-05-31T18:45:00Z"
        }
      ],
      "countries": [
        {
          "type": "BR",
          "visits": 1,
          "requests": 4,
          "bytes": 9677,
          "date": "2025-05-31T18:45:00Z"
        }
      ],
      "devices": [
        {
          "type": "desktop",
          "visits": 1,
          "requests": 4,
          "bytes": 9677,
          "date": "2025-05-31T18:45:00Z"
        }
      ],
      "os": [
        {
          "type": "Windows",
          "visits": 1,
          "requests": 4,
          "bytes": 9677,
          "date": "2025-05-31T18:45:00Z"
        }
      ],
      "browsers": [
        {
          "type": "Chrome",
          "visits": 1,
          "requests": 4,
          "bytes": 9677,
          "date": "2025-05-31T18:45:00Z"
        }
      ],
      "protocols": [
        {
          "type": "https",
          "visits": 1,
          "requests": 4,
          "bytes": 9677,
          "date": "2025-05-31T18:45:00Z"
        }
      ],
      "methods": [
        {
          "type": "GET",
          "visits": 1,
          "requests": 4,
          "bytes": 9677,
          "date": "2025-05-31T18:45:00Z"
        }
      ],
      "paths": [
        {
          "type": "/",
          "visits": 1,
          "requests": 4,
          "bytes": 9677,
          "date": "2025-05-31T18:45:00Z"
        }
      ],
      "referers": [
        {
          "type": "https://google.com",
          "visits": 1,
          "requests": 4,
          "bytes": 9677,
          "date": "2025-05-31T18:45:00Z"
        }
      ],
      "providers": [
        {
          "type": "Cloudflare",
          "visits": 1,
          "requests": 4,
          "bytes": 9677,
          "date": "2025-05-31T18:45:00Z"
        }
      ]
    }
  }
  ```
</ResponseExample>