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

# Relatórios de monitores: taxa de menção, share of voice e análises

> Leia o relatório de um monitor em um único endpoint, com janela, filtros, denominadores e regras de comparação explícitos.

`GET /v1/monitors/{id}/analytics` ([referência](/pt/api-reference/monitors/get-analytics.md)) retorna cada
número do relatório de um monitor a partir de um único conjunto de respostas: uma janela, um conjunto de filtros e a mesma janela
imediatamente anterior para comparação. Monte cada painel do seu próprio relatório com este endpoint e leia `quality`
antes dos números. Ler um relatório não custa nada.

```bash theme={"theme":"css-variables"}
curl "https://api.querying.ai/v1/monitors/$MONITOR_ID/analytics?since=2026-10-16T00:00:00Z&until=2026-10-18T00:00:00Z&engine=CHATGPT" \
  -H "Authorization: Bearer $QUERYING_API_KEY"
```

## Parâmetros de consulta

| Parâmetro | Descrição |
| - | - |
| `days` | `7`, `30` (padrão) ou `90`: a janela termina agora. Não pode ser combinado com `since` e `until`. |
| `since`, `until` | Uma janela fixa. Envie os dois, como instantes ISO 8601 com fuso horário, por exemplo `2026-10-16T00:00:00Z`. O intervalo precisa ser positivo e ter no máximo 90 dias, e `until` não pode estar no futuro. Uma data sozinha, como `2026-10-16`, é recusada. |
| `engine` | Só respostas deste mecanismo: um id de mecanismo de monitor ou um dos seus aliases, como `GOOGLE_AIO`. |
| `prompt` | Só respostas a este prompt, pelo texto exato, de 1 a 2.000 caracteres. As respostas são guardadas pelo texto do prompt, então um prompt que você removeu do monitor continua consultável. |

A janela é semiaberta e em UTC: `since` entra, `until` não. A janela anterior tem exatamente
a mesma duração, termina em `since` e usa os mesmos filtros, então toda comparação é equivalente. Envie
cada parâmetro uma única vez.

## Exemplo

Por exemplo, um monitor de marca que pergunta dois prompts ao ChatGPT uma vez por dia com `samples: 5` (dez respostas por
dia), filtrado para o ChatGPT ao longo de dois dias, retorna:

> **Resposta completa**
>
> ```json theme={"theme":"css-variables"}
> {
>   "success": true,
>   "data": {
>     "monitor": {
>       "id": "d39b8de0-b159-4229-bf58-7064e5369db1",
>       "name": "Earbud brand tracking",
>       "mode": "BRAND",
>       "category": null,
>       "promptTopics": {},
>       "engines": ["CHATGPT", "GEMINI"],
>       "prompts": ["best wireless earbuds for commuting", "are cheap earbuds worth it"],
>       "aliases": ["Acme Audio", "Acme"],
>       "domains": ["acme-audio.example"],
>       "country": "US",
>       "intervalHours": 24,
>       "enabled": true,
>       "alertBelowPct": 40,
>       "competitors": [
>         { "name": "Northwind Audio", "aliases": ["Northwind Audio"], "source": "user" },
>         { "name": "Contoso Sound", "aliases": ["Contoso Sound", "Contoso"], "source": "user" }
>       ],
>       "competitorsReadAt": "2026-10-17T03:10:22.004Z",
>       "location": null,
>       "grid": null,
>       "engineSettings": { "CHATGPT": { "samples": 5 } },
>       "webhookUrl": null,
>       "analysis": false,
>       "nextRunAt": "2026-10-19T09:00:02.118Z",
>       "lastRunAt": "2026-10-18T09:00:01.730Z",
>       "shareAccess": "PRIVATE",
>       "shareSlug": null,
>       "createdAt": "2026-10-09T08:59:57.410Z",
>       "updatedAt": "2026-10-12T14:21:09.882Z"
>     },
>     "window": {
>       "since": "2026-10-16T00:00:00.000Z",
>       "until": "2026-10-18T00:00:00.000Z",
>       "previousSince": "2026-10-14T00:00:00.000Z",
>       "previousUntil": "2026-10-16T00:00:00.000Z",
>       "timezone": "UTC",
>       "bounds": "[since, until)"
>     },
>     "filters": { "engine": "CHATGPT", "prompt": null },
>     "stats": { "runs": 20, "mentioned": 9, "cited": 3, "competitorOnly": 7, "mentionRate": 45, "citationRate": 15, "competitorOnlyRate": 35 },
>     "previous": { "runs": 20, "mentioned": 12, "cited": 4, "competitorOnly": 5, "mentionRate": 60, "citationRate": 20, "competitorOnlyRate": 25 },
>     "changes": { "mentionRatePp": -15, "citationRatePp": -5 },
>     "engineRates": [
>       { "engine": "CHATGPT", "runs": 20, "mentioned": 9, "cited": 3, "competitorOnly": 7, "mentionRate": 45, "citationRate": 15, "competitorOnlyRate": 35 }
>     ],
>     "series": [
>       {
>         "day": "2026-10-16",
>         "engine": "CHATGPT",
>         "partial": false,
>         "runs": 10,
>         "mentioned": 5,
>         "cited": 2,
>         "competitorOnly": 3,
>         "mentionRate": 50,
>         "citationRate": 20,
>         "competitorOnlyRate": 30
>       },
>       {
>         "day": "2026-10-17",
>         "engine": "CHATGPT",
>         "partial": false,
>         "runs": 10,
>         "mentioned": 4,
>         "cited": 1,
>         "competitorOnly": 4,
>         "mentionRate": 40,
>         "citationRate": 10,
>         "competitorOnlyRate": 40
>       }
>     ],
>     "brands": [
>       {
>         "name": "Northwind Audio",
>         "mentions": 10,
>         "sampleSize": 20,
>         "mentionRate": 50,
>         "shareOfVoice": 43.47826086956522,
>         "previousMentionRate": 40,
>         "previousShareOfVoice": 33.33333333333333,
>         "configured": true
>       },
>       {
>         "name": "__you__",
>         "mentions": 9,
>         "sampleSize": 20,
>         "mentionRate": 45,
>         "shareOfVoice": 39.130434782608695,
>         "previousMentionRate": 60,
>         "previousShareOfVoice": 50,
>         "configured": true
>       },
>       {
>         "name": "Contoso Sound",
>         "mentions": 4,
>         "sampleSize": 20,
>         "mentionRate": 20,
>         "shareOfVoice": 17.391304347826086,
>         "previousMentionRate": 20,
>         "previousShareOfVoice": 16.666666666666664,
>         "configured": true
>       }
>     ],
>     "voiceSeries": [
>       { "day": "2026-10-16", "name": "__you__", "mentions": 5, "runs": 10, "mentionRate": 50, "shareOfVoice": 41.66666666666667 },
>       { "day": "2026-10-16", "name": "Northwind Audio", "mentions": 5, "runs": 10, "mentionRate": 50, "shareOfVoice": 41.66666666666667 },
>       { "day": "2026-10-16", "name": "Contoso Sound", "mentions": 2, "runs": 10, "mentionRate": 20, "shareOfVoice": 16.666666666666664 },
>       { "day": "2026-10-17", "name": "__you__", "mentions": 4, "runs": 10, "mentionRate": 40, "shareOfVoice": 36.36363636363637 },
>       { "day": "2026-10-17", "name": "Northwind Audio", "mentions": 5, "runs": 10, "mentionRate": 50, "shareOfVoice": 45.45454545454545 },
>       { "day": "2026-10-17", "name": "Contoso Sound", "mentions": 2, "runs": 10, "mentionRate": 20, "shareOfVoice": 18.181818181818183 }
>     ],
>     "prompts": [
>       {
>         "prompt": "are cheap earbuds worth it",
>         "runs": 10,
>         "mentioned": 3,
>         "cited": 0,
>         "competitorOnly": 4,
>         "mentionRate": 30,
>         "citationRate": 0,
>         "competitorOnlyRate": 40,
>         "previous": { "runs": 10, "mentioned": 5, "cited": 1, "competitorOnly": 3, "mentionRate": 50, "citationRate": 10, "competitorOnlyRate": 30 },
>         "engines": [
>           {
>             "prompt": "are cheap earbuds worth it",
>             "engine": "CHATGPT",
>             "runs": 10,
>             "mentioned": 3,
>             "cited": 0,
>             "competitorOnly": 4,
>             "mentionRate": 30,
>             "citationRate": 0,
>             "competitorOnlyRate": 40,
>             "previous": { "runs": 10, "mentioned": 5, "cited": 1, "competitorOnly": 3, "mentionRate": 50, "citationRate": 10, "competitorOnlyRate": 30 },
>             "mentionRateChangePp": -20,
>             "topCompetitor": "Northwind Audio",
>             "topCompetitorRate": 60,
>             "evidenceTaskId": "6f1c2a9e-3b4d-4e5f-8a7b-1c2d3e4f5a63",
>             "mentionTaskId": "6f1c2a9e-3b4d-4e5f-8a7b-1c2d3e4f5a63",
>             "latestTaskId": "6f1c2a9e-3b4d-4e5f-8a7b-1c2d3e4f5a63"
>           }
>         ]
>       },
>       {
>         "prompt": "best wireless earbuds for commuting",
>         "runs": 10,
>         "mentioned": 6,
>         "cited": 3,
>         "competitorOnly": 3,
>         "mentionRate": 60,
>         "citationRate": 30,
>         "competitorOnlyRate": 30,
>         "previous": { "runs": 10, "mentioned": 7, "cited": 3, "competitorOnly": 2, "mentionRate": 70, "citationRate": 30, "competitorOnlyRate": 20 },
>         "engines": [
>           {
>             "prompt": "best wireless earbuds for commuting",
>             "engine": "CHATGPT",
>             "runs": 10,
>             "mentioned": 6,
>             "cited": 3,
>             "competitorOnly": 3,
>             "mentionRate": 60,
>             "citationRate": 30,
>             "competitorOnlyRate": 30,
>             "previous": { "runs": 10, "mentioned": 7, "cited": 3, "competitorOnly": 2, "mentionRate": 70, "citationRate": 30, "competitorOnlyRate": 20 },
>             "mentionRateChangePp": -10,
>             "topCompetitor": "Northwind Audio",
>             "topCompetitorRate": 40,
>             "evidenceTaskId": "6f1c2a9e-3b4d-4e5f-8a7b-1c2d3e4f5a61",
>             "mentionTaskId": "6f1c2a9e-3b4d-4e5f-8a7b-1c2d3e4f5a61",
>             "latestTaskId": "6f1c2a9e-3b4d-4e5f-8a7b-1c2d3e4f5a61"
>           }
>         ]
>       }
>     ],
>     "opportunities": [
>       {
>         "prompt": "are cheap earbuds worth it",
>         "engine": "CHATGPT",
>         "runs": 10,
>         "mentioned": 3,
>         "cited": 0,
>         "competitorOnly": 4,
>         "mentionRate": 30,
>         "citationRate": 0,
>         "competitorOnlyRate": 40,
>         "previous": { "runs": 10, "mentioned": 5, "cited": 1, "competitorOnly": 3, "mentionRate": 50, "citationRate": 10, "competitorOnlyRate": 30 },
>         "mentionRateChangePp": -20,
>         "topCompetitor": "Northwind Audio",
>         "topCompetitorRate": 60,
>         "evidenceTaskId": "6f1c2a9e-3b4d-4e5f-8a7b-1c2d3e4f5a63",
>         "mentionTaskId": "6f1c2a9e-3b4d-4e5f-8a7b-1c2d3e4f5a63",
>         "latestTaskId": "6f1c2a9e-3b4d-4e5f-8a7b-1c2d3e4f5a63"
>       },
>       {
>         "prompt": "best wireless earbuds for commuting",
>         "engine": "CHATGPT",
>         "runs": 10,
>         "mentioned": 6,
>         "cited": 3,
>         "competitorOnly": 3,
>         "mentionRate": 60,
>         "citationRate": 30,
>         "competitorOnlyRate": 30,
>         "previous": { "runs": 10, "mentioned": 7, "cited": 3, "competitorOnly": 2, "mentionRate": 70, "citationRate": 30, "competitorOnlyRate": 20 },
>         "mentionRateChangePp": -10,
>         "topCompetitor": "Northwind Audio",
>         "topCompetitorRate": 40,
>         "evidenceTaskId": "6f1c2a9e-3b4d-4e5f-8a7b-1c2d3e4f5a61",
>         "mentionTaskId": "6f1c2a9e-3b4d-4e5f-8a7b-1c2d3e4f5a61",
>         "latestTaskId": "6f1c2a9e-3b4d-4e5f-8a7b-1c2d3e4f5a61"
>       }
>     ],
>     "quality": {
>       "comparable": true,
>       "comparisonReason": null,
>       "scoringVersions": ["3f9a6c1e8b2d4f7a9c0e1b3d5f7a9c1e3b5d7f9a1c3e5b7d9f1a3c5e7b9d1f3a"],
>       "noAnswerObservations": 0,
>       "unknownObservations": 0,
>       "noAnswerIncluded": true,
>       "historicalFailures": null,
>       "sampleSize": 20,
>       "previousSampleSize": 20,
>       "configuredCells": 2,
>       "observedCells": 2,
>       "missingCells": 0,
>       "lowSample": true,
>       "partialDays": [],
>       "denominator": "scored_answers",
>       "shareOfVoiceDenominator": "tracked_brand_mentions",
>       "trackedBrandMentions": 23,
>       "answerTextLimit": 8000,
>       "scoring": "collection_time_definitions",
>       "failedTasksIncluded": false
>     },
>     "pauses": [],
>     "health": { "completed": 12, "failed": 0, "pending": 0, "topError": null },
>     "healthScope": "recent_visible_tasks"
>   }
> }
> ```

Como ler: a marca foi citada em 9 de 20 respostas do ChatGPT (45%), 15 pontos a menos que nos dois dias
anteriores. A Northwind Audio foi citada em mais respostas, e "are cheap earbuds worth it" é o prompt mais
fraco, com 4 respostas que citaram um concorrente e não a marca. `quality.lowSample` é `true`, então trate
a variação como um sinal a verificar, não como tendência.

## Seções da resposta

| Campo | Conteúdo |
| - | - |
| `monitor` | A definição armazenada do monitor. |
| `window` | `since`, `until`, `previousSince`, `previousUntil`, `timezone` (`UTC`) e `bounds` (`[since, until)`). `previousUntil` é sempre igual a `since`. |
| `filters` | Os filtros aplicados, já resolvidos: o id canônico do mecanismo, o prompt exato ou `null`. |
| `stats`, `previous` | Contagens e taxas da janela e da janela anterior. Veja [Objetos de taxa](#objetos-de-taxa). |
| `changes` | `mentionRatePp` e `citationRatePp`: a variação em pontos percentuais, ou `null` quando a comparação é retida. |
| `engineRates` | O objeto de taxa por mecanismo. |
| `series` | O objeto de taxa por dia UTC e mecanismo, com `partial: true` em um dia que a janela cobre só em parte. |
| `brands` | Sua marca (`__you__`) e cada concorrente citado na janela, do mais mencionado para o menos. Veja [Marcas e share of voice](#marcas-e-share-of-voice). |
| `voiceSeries` | Por dia UTC e marca: `mentions`, `runs` (as respostas do dia), `mentionRate` e `shareOfVoice`. |
| `prompts` | Por prompt, da menor taxa de menção para a maior: o objeto de taxa, `previous` e `engines`, uma célula por mecanismo. |
| `opportunities` | Células em que um concorrente foi citado e a sua marca não (`competitorOnly` acima de 0), das que têm mais respostas assim para as que têm menos. A lista para trabalhar. |
| `quality` | Do que a amostra é feita e o que os números não conseguem dizer. Veja [Qualidade](#qualidade). |
| `pauses` | Pausas que se sobrepõem à janela, da mais antiga para a mais nova: `pausedAt` e `resumedAt` (`null` enquanto pausado). |
| `health`, `healthScope` | Estado recente das tarefas, um escopo separado do relatório. Veja [Saúde](#saúde). |

### Objetos de taxa

`stats`, `previous`, cada entrada de `engineRates` e `series`, cada prompt e cada célula trazem os mesmos
campos:

| Campo | Significado |
| - | - |
| `runs` | Respostas pontuadas. O denominador de cada taxa abaixo. |
| `mentioned` | Respostas que citaram a sua marca. |
| `cited` | Respostas que citaram um dos seus domínios. |
| `competitorOnly` | Respostas que citaram pelo menos um concorrente e não a sua marca. |
| `mentionRate`, `citationRate`, `competitorOnlyRate` | `100 × contagem / runs`, ou `null` quando `runs` é 0. |

### Células

Uma célula é um prompt em um mecanismo. Além do objeto de taxa e de `previous`, ela traz:

| Campo | Significado |
| - | - |
| `mentionRateChangePp` | A variação da célula em pontos, ou `null` quando a comparação é retida. |
| `topCompetitor` | O concorrente citado no maior número de respostas da célula, ou `null`. |
| `topCompetitorRate` | A taxa de menção desse concorrente na célula, ou `null` quando algumas respostas da célula são anteriores ao contexto de pontuação armazenado. |
| `evidenceTaskId` | A resposta mais recente que citou um concorrente e não a sua marca. |
| `mentionTaskId` | A resposta mais recente que citou a sua marca. |
| `latestTaskId` | A resposta mais recente. |

Cada id é `null` quando nenhuma resposta se qualifica. Abra um com
[`GET /v1/monitors/{id}/answers/{taskId}`](/pt/monitors/evidence#leia-uma-resposta).

### Marcas e share of voice

Cada entrada de `brands` tem `name`, `mentions`, `sampleSize`, `mentionRate`, `shareOfVoice`,
`previousMentionRate`, `previousShareOfVoice` e `configured` (`false` para uma marca citada na janela
que não está mais no monitor).

## O que os números significam

`GET /v1/monitors/capabilities` retorna estas definições como `metrics`, para que um cliente possa exibi-las ao lado
dos números.

* **`mentionRate`** é `100 × mentioned / respostas pontuadas`, para a janela, cada mecanismo, cada dia e cada
  célula. É ponderado por respostas, não uma média entre mecanismos, então um mecanismo movimentado não é sufocado por um
  quieto.
* **`citationRate`** tem o mesmo formato para as respostas que citaram um dos seus domínios. Sem domínios, é
  sempre 0, porque o rastreamento de citações fica desligado.
* **A taxa de uma marca divide pelo próprio `sampleSize`.** Para a sua marca, são todas as respostas pontuadas. Para um
  concorrente, só as respostas pontuadas enquanto ele estava no monitor, então um concorrente adicionado hoje é
  medido a partir de hoje. O `mentionRate` de um concorrente é `null` quando algumas respostas da janela foram pontuadas
  antes de o contexto de pontuação ser armazenado, porque não se sabe com o que elas foram comparadas.
* **`shareOfVoice`** é `100 × menções daquela marca / todas as menções de marcas acompanhadas` na janela, então as
  participações de uma janela somam 100 (`quality.trackedBrandMentions` é o denominador). Ele compara
  marcas dentro das respostas que você coletou para estes prompts. Não é participação de mercado nem ranking de
  visibilidade.
* **`competitorOnly`** e `opportunities` contam as respostas que citaram um concorrente enquanto a sua marca estava
  ausente: a lacuna sobre a qual você pode agir.
* **`null` não é 0.** Uma taxa é `null` quando não havia respostas para dividir. 0 significa que houve
  respostas e nenhuma correspondeu.
* **Uma resposta sem texto conta como não mencionada.** Uma tarefa concluída que não retornou resposta fica no
  denominador; `quality.noAnswerObservations` as conta. Uma tarefa **com falha** é excluída de todas as
  taxas e aparece só em `health`. Um mecanismo quebrado encolhe a amostra em vez de aparecer como ausência.
* **`position`** em uma resposta pontuada é o offset de caractere da primeira ocorrência da sua marca: um indicador de
  destaque, não um ranking. É `null` quando a marca não aparece.

### Quando as variações são retidas

`changes`, o `mentionRateChangePp` de cada célula e o `previousMentionRate` e o
`previousShareOfVoice` de cada marca ficam `null`, e `quality.comparable` fica `false`, quando as duas janelas não podem ser
comparadas. `quality.comparisonReason` diz por quê:

| `comparisonReason` | Significado |
| - | - |
| `insufficient_periods` | Uma das duas janelas não tem respostas. |
| `legacy_scoring_unknown` | Algumas respostas foram pontuadas antes de a definição usada para pontuá-las ser armazenada. |
| `scoring_definitions_changed` | Os aliases, domínios, concorrentes ou o país mudaram entre as respostas das duas janelas. |

Cada resposta mantém a definição com que foi pontuada, e `quality.scoringVersions` lista as definições
distintas nas duas janelas (`legacy` para respostas sem definição). Mudar seus aliases ou concorrentes
nunca reescreve respostas passadas. A única exceção é a leitura semanal de concorrentes: quando os concorrentes que ela
encontra mudam, as respostas armazenadas do monitor são pontuadas de novo com a nova lista.

### Qualidade

| Campo | Significado |
| - | - |
| `comparable`, `comparisonReason` | Se os números de variação são mostrados e, se não, por quê. |
| `scoringVersions` | As definições de pontuação distintas nas duas janelas. |
| `scoring` | Sempre `collection_time_definitions`: as respostas são pontuadas com a definição em vigor quando chegaram. |
| `sampleSize`, `previousSampleSize` | Respostas pontuadas em cada janela. |
| `lowSample` | `true` abaixo de 30 respostas pontuadas na janela. |
| `configuredCells`, `observedCells`, `missingCells` | Células prompt × mecanismo que os filtros cobrem, células com pelo menos uma resposta e a diferença. |
| `partialDays` | Dias UTC que a janela corta, ou que ainda não terminaram. A contagem menor de um dia parcial é aritmética, não queda. |
| `noAnswerObservations` | Respostas concluídas sem texto, contadas como não mencionadas. |
| `unknownObservations` | Respostas pontuadas antes de o contexto de pontuação ser armazenado. |
| `noAnswerIncluded`, `failedTasksIncluded`, `historicalFailures` | Sempre `true`, `false` e `null`: respostas sem texto ficam no denominador, tarefas com falha não, e falhas nunca são reconstruídas a partir do histórico. |
| `denominator`, `shareOfVoiceDenominator` | `scored_answers` e `tracked_brand_mentions`. |
| `trackedBrandMentions` | O denominador do share of voice. |
| `answerTextLimit` | `8000`: o texto armazenado da resposta é cortado em 8.000 caracteres. |

### Saúde

`health` tem `completed`, `failed`, `pending` e `topError` (o código de erro mais comum entre as tarefas com
falha) para as tarefas do monitor em andamento ou concluídas nas últimas 24 horas. `healthScope` é
sempre `recent_visible_tasks`. É um diagnóstico das execuções, independente da janela, e nunca faz parte do
denominador de uma taxa.

## Polling durante uma execução

Toda chamada retorna o relatório completo da janela e dos filtros. Enquanto uma execução está em andamento,
`health.pending` conta as tarefas dela que ainda estão rodando. Leia o relatório de novo quando ele chegar a 0.

## Relatórios de categoria

Um [monitor de categoria](/pt/monitors.md#monitores-de-categoria) retorna um corpo diferente pelo mesmo endpoint, com
os mesmos `window`, `filters`, `quality`, `pauses` e `health`:

* `stats` e `previous` trazem `runs`, `named` (respostas que citaram pelo menos uma marca acompanhada) e
  `namedRate`. `changes.namedRatePp` é a variação em pontos.
* `category` traz o ranking:

| Campo | Conteúdo |
| - | - |
| `category.name` | O `category` do monitor. |
| `category.brands` | Cada marca acompanhada e cada marca que as respostas citaram, da mais mencionada para a menos: `name`, `rank`, `mentions`, `sampleSize`, `mentionRate`, `shareOfVoice`, `previousMentionRate`, `previousShareOfVoice`, `changePp` e `configured`. |
| `category.topics` | Uma linha por subárea (`topic: null` é a categoria inteira): `prompts`, `runs`, `named`, `namedRate` e `leaders`, as três marcas mais citadas. |
| `category.engines` | Uma linha por mecanismo com respostas na janela: `runs`, `named`, `namedRate` e `leaders`. |
| `category.series` | Por dia UTC, as cinco marcas acompanhadas líderes: `mentions`, `sampleSize`, `runs`, `mentionRate` e `partial`. |
| `category.prompts` | Uma linha por prompt: `topic`, `retired` (`true` para um prompt que não está mais no monitor), `runs`, `named`, `namedRate`, `leaders` e `engines`, cada um com `runs`, `named` e um `evidenceTaskId` da resposta mais recente que citou uma marca. |

Por exemplo, uma entrada de `category.brands`:

```json theme={"theme":"css-variables"}
{
  "name": "Northwind Sun",
  "mentions": 18,
  "sampleSize": 40,
  "mentionRate": 45,
  "shareOfVoice": 30,
  "previousMentionRate": 40,
  "previousShareOfVoice": 25,
  "changePp": 5,
  "configured": true,
  "rank": 1
}
```

* **`rank`** ordena as marcas pelo número de respostas que as citam. Uma marca que nenhuma resposta citou tem
  `rank: null`.
* **`mentionRate`** divide pelo próprio `sampleSize` da marca: as respostas pontuadas enquanto ela estava na lista.
* **`shareOfVoice`** é `100 × menções daquela marca / todas as menções de marcas` na janela, então as participações somam
  100\.

## Erros e limites

* A janela tem no máximo 90 dias.
* Parâmetros inválidos retornam `400 VALIDATION_ERROR` com uma mensagem que indica o problema: `days` com `since`
  ou `until`, só um entre `since` e `until`, um timestamp sem fuso horário, um intervalo acima de 90 dias, um
  `until` no futuro, um mecanismo que não pode ser monitorado, um prompt acima de 2.000 caracteres ou um
  parâmetro repetido.
* Um relatório grande demais para agregar retorna `400 VALIDATION_ERROR` com "This report is too large". Restrinja
  a janela, o mecanismo ou o prompt.

Veja [Monitores](/pt/monitors.md#erros) para os códigos que todos os endpoints de monitor compartilham.

## Próximos passos

> **[Fontes e respostas](/pt/monitors/evidence.md)**
>
> As páginas citadas e as respostas por trás de cada número.

> **[Eventos e alertas](/pt/monitors/events-and-alerts.md)**
>
> Seja avisado quando as respostas mudarem.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.