> ## 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.

# Monitor-Berichte: Nennungsquote, Share of Voice und Analysen

> Lesen Sie den Bericht eines Monitors über einen Endpunkt, mit explizitem Fenster, Filtern, Nennern und Vergleichsregeln.

`GET /v1/monitors/{id}/analytics` ([Referenz](/de/api-reference/monitors/get-analytics.md)) liefert jede Zahl im Bericht
eines Monitors aus einem Satz von Antworten: ein Fenster, ein Filtersatz und dasselbe Fenster davor zum Vergleich.
Bauen Sie jedes Panel Ihres eigenen Berichts aus diesem Endpunkt und lesen Sie `quality` vor den Zahlen. Das Lesen eines
Berichts kostet nichts.

```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"
```

## Query-Parameter

| Parameter | Beschreibung |
| - | - |
| `days` | `7`, `30` (Standard) oder `90`: Das Fenster endet jetzt. Nicht mit `since` und `until` kombinierbar. |
| `since`, `until` | Ein festes Fenster. Senden Sie beide, als ISO-8601-Zeitpunkte mit Zeitzone, etwa `2026-10-16T00:00:00Z`. Die Spanne muss positiv sein und höchstens 90 Tage betragen, und `until` darf nicht in der Zukunft liegen. Ein bloßes Datum wie `2026-10-16` wird abgelehnt. |
| `engine` | Nur Antworten dieser Engine: eine Monitor-Engine-id oder einer ihrer Aliase, etwa `GOOGLE_AIO`. |
| `prompt` | Nur Antworten auf diesen Prompt, nach exaktem Text, 1–2.000 Zeichen. Antworten werden nach Prompt-Text gespeichert, ein aus dem Monitor entfernter Prompt bleibt also abfragbar. |

Das Fenster ist halboffen und in UTC: `since` ist enthalten, `until` nicht. Das vorherige Fenster hat exakt dieselbe
Länge, endet bei `since` und nutzt dieselben Filter, jeder Vergleich erfolgt also unter gleichen Bedingungen. Senden Sie
jeden Parameter einmal.

## Beispiel

Ein Marken-Monitor, der ChatGPT einmal täglich zwei Prompts mit `samples: 5` stellt (zehn Antworten pro Tag), gefiltert
auf ChatGPT über zwei Tage, liefert zum Beispiel:

> **Vollständige Antwort**
>
> ```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"
>   }
> }
> ```

So lesen Sie es: Die Marke wurde in 9 von 20 ChatGPT-Antworten genannt (45 %), 15 Punkte weniger als in den zwei Tagen
davor. Northwind Audio wurde in mehr Antworten genannt, und „are cheap earbuds worth it“ ist der schwächste Prompt, mit 4
Antworten, die einen Wettbewerber nannten und die Marke nicht. `quality.lowSample` ist `true`, behandeln Sie die
Veränderung also als Anlass zur Prüfung, nicht als Trend.

## Abschnitte der Antwort

| Feld | Inhalt |
| - | - |
| `monitor` | Die gespeicherte Monitor-Definition. |
| `window` | `since`, `until`, `previousSince`, `previousUntil`, `timezone` (`UTC`) und `bounds` (`[since, until)`). `previousUntil` ist immer gleich `since`. |
| `filters` | Die angewandten, aufgelösten Filter: die kanonische Engine-id, der exakte Prompt oder `null`. |
| `stats`, `previous` | Zählwerte und Quoten für das Fenster und das Fenster davor. Siehe [Quotenobjekte](#quotenobjekte). |
| `changes` | `mentionRatePp` und `citationRatePp`: die Veränderung in Prozentpunkten, oder `null`, wenn der Vergleich zurückgehalten wird. |
| `engineRates` | Das Quotenobjekt pro Engine. |
| `series` | Das Quotenobjekt pro UTC-Tag und Engine, mit `partial: true` an einem Tag, den das Fenster nur teilweise abdeckt. |
| `brands` | Ihre Marke (`__you__`) und jeder im Fenster genannte Wettbewerber, meiste Nennungen zuerst. Siehe [Marken und Share of Voice](#marken-und-share-of-voice). |
| `voiceSeries` | Pro UTC-Tag und Marke: `mentions`, `runs` (die Antworten des Tages), `mentionRate` und `shareOfVoice`. |
| `prompts` | Pro Prompt, schwächste Nennungsquote zuerst: das Quotenobjekt, `previous` und `engines`, eine Zelle pro Engine. |
| `opportunities` | Zellen, in denen ein Wettbewerber genannt wurde und Ihre Marke nicht (`competitorOnly` über 0), meiste solche Antworten zuerst. Die Liste, mit der Sie arbeiten. |
| `quality` | Woraus die Stichprobe besteht und was die Zahlen nicht aussagen können. Siehe [Qualität](#qualität). |
| `pauses` | Pausen, die das Fenster überlappen, älteste zuerst: `pausedAt` und `resumedAt` (`null`, solange pausiert). |
| `health`, `healthScope` | Aktueller Task-Status, ein vom Bericht getrennter Umfang. Siehe [Laufzustand](#laufzustand). |

### Quotenobjekte

`stats`, `previous`, jeder Eintrag in `engineRates` und `series`, jeder Prompt und jede Zelle tragen dieselben Felder:

| Feld | Bedeutung |
| - | - |
| `runs` | Bewertete Antworten. Der Nenner jeder Quote unten. |
| `mentioned` | Antworten, die Ihre Marke nannten. |
| `cited` | Antworten, die eine Ihrer Domains zitierten. |
| `competitorOnly` | Antworten, die mindestens einen Wettbewerber nannten und Ihre Marke nicht. |
| `mentionRate`, `citationRate`, `competitorOnlyRate` | `100 × count / runs`, oder `null`, wenn `runs` 0 ist. |

### Zellen

Eine Zelle ist ein Prompt auf einer Engine. Neben dem Quotenobjekt und `previous` trägt sie:

| Feld | Bedeutung |
| - | - |
| `mentionRateChangePp` | Die Veränderung der Zelle in Punkten, oder `null`, wenn der Vergleich zurückgehalten wird. |
| `topCompetitor` | Der Wettbewerber, der in den meisten Antworten der Zelle genannt wurde, oder `null`. |
| `topCompetitorRate` | Die Nennungsquote dieses Wettbewerbers in der Zelle, oder `null`, wenn einige Antworten der Zelle älter als der gespeicherte Bewertungskontext sind. |
| `evidenceTaskId` | Die neueste Antwort, die einen Wettbewerber nannte und Ihre Marke nicht. |
| `mentionTaskId` | Die neueste Antwort, die Ihre Marke nannte. |
| `latestTaskId` | Die neueste Antwort. |

Jede id ist `null`, wenn keine Antwort infrage kommt. Öffnen Sie eine mit
[`GET /v1/monitors/{id}/answers/{taskId}`](/de/monitors/evidence#eine-antwort-lesen).

### Marken und Share of Voice

Jeder Eintrag in `brands` hat `name`, `mentions`, `sampleSize`, `mentionRate`, `shareOfVoice`,
`previousMentionRate`, `previousShareOfVoice` und `configured` (`false` für eine im Fenster genannte Marke, die nicht
mehr am Monitor ist).

## Was die Zahlen bedeuten

`GET /v1/monitors/capabilities` liefert diese Definitionen als `metrics`, damit ein Client sie neben den Zahlen anzeigen
kann.

* **`mentionRate`** ist `100 × mentioned / bewertete Antworten`, für das Fenster, jede Engine, jeden Tag und jede Zelle.
  Sie ist nach Antworten gewichtet, kein Mittelwert über Engines, sodass eine vielgenutzte Engine nicht von einer wenig
  genutzten überstimmt wird.
* **`citationRate`** hat dieselbe Form für Antworten, die eine Ihrer Domains zitierten. Ohne Domains ist sie immer 0,
  weil die Zitationsverfolgung aus ist.
* **Die Quote einer Marke teilt durch ihre eigene `sampleSize`.** Für Ihre Marke sind das alle bewerteten Antworten. Für
  einen Wettbewerber nur die Antworten, die bewertet wurden, während er am Monitor war; ein heute hinzugefügter
  Wettbewerber wird also ab heute gemessen. Die `mentionRate` eines Wettbewerbers ist `null`, wenn einige Antworten im
  Fenster bewertet wurden, bevor der Bewertungskontext gespeichert wurde, weil unbekannt ist, wogegen sie abgeglichen wurden.
* **`shareOfVoice`** ist `100 × Nennungen dieser Marke / alle Nennungen verfolgter Marken` im Fenster, die Anteile eines
  Fensters ergeben also zusammen 100 (`quality.trackedBrandMentions` ist der Nenner). Es vergleicht Marken innerhalb der
  Antworten, die Sie für diese Prompts gesammelt haben. Es ist weder Marktanteil noch ein Sichtbarkeitsranking.
* **`competitorOnly`** und `opportunities` zählen Antworten, die einen Wettbewerber nannten, während Ihre Marke fehlte:
  die Lücke, an der Sie ansetzen können.
* **`null` ist nicht 0.** Eine Quote ist `null`, wenn es keine Antworten gab, durch die geteilt werden könnte. 0 bedeutet,
  dass es Antworten gab und keine passte.
* **Eine Antwort ohne Text zählt als nicht genannt.** Ein abgeschlossener Task ohne Antwort bleibt im Nenner;
  `quality.noAnswerObservations` zählt sie. Ein **fehlgeschlagener** Task wird aus allen Quoten ausgeschlossen und
  erscheint nur in `health`. Eine defekte Engine verkleinert die Stichprobe, statt als Abwesenheit aufzutauchen.
* **`position`** einer bewerteten Antwort ist der Zeichen-Offset des ersten Treffers Ihrer Marke: ein Näherungswert für
  Prominenz, kein Rang. Sie ist `null`, wenn die Marke fehlt.

### Zurückgehaltene Veränderungen

`changes`, das `mentionRateChangePp` jeder Zelle sowie `previousMentionRate` und `previousShareOfVoice` jeder Marke sind
`null`, und `quality.comparable` ist `false`, wenn sich die beiden Fenster nicht vergleichen lassen.
`quality.comparisonReason` nennt den Grund:

| `comparisonReason` | Bedeutung |
| - | - |
| `insufficient_periods` | Eines der beiden Fenster hat keine Antworten. |
| `legacy_scoring_unknown` | Einige Antworten wurden bewertet, bevor die Definition, gegen die sie bewertet wurden, gespeichert wurde. |
| `scoring_definitions_changed` | Aliase, Domains, Wettbewerber oder Land haben sich zwischen den Antworten der beiden Fenster geändert. |

Jede Antwort behält die Definition, mit der sie bewertet wurde, und `quality.scoringVersions` listet die
unterschiedlichen Definitionen über beide Fenster (`legacy` für Antworten ohne eine). Änderungen an Aliasen oder
Wettbewerbern schreiben vergangene Antworten nie um. Einzige Ausnahme ist die wöchentliche Wettbewerber-Auswertung:
Ändern sich die gefundenen Wettbewerber, werden die gespeicherten Antworten des Monitors gegen die neue Liste erneut
bewertet.

### Qualität

| Feld | Bedeutung |
| - | - |
| `comparable`, `comparisonReason` | Ob die Veränderungswerte angezeigt werden, und warum nicht. |
| `scoringVersions` | Die unterschiedlichen Bewertungsdefinitionen in beiden Fenstern. |
| `scoring` | Immer `collection_time_definitions`: Antworten werden mit der Definition bewertet, die bei ihrem Eintreffen galt. |
| `sampleSize`, `previousSampleSize` | Bewertete Antworten in jedem Fenster. |
| `lowSample` | `true` unter 30 bewerteten Antworten im Fenster. |
| `configuredCells`, `observedCells`, `missingCells` | Prompt × Engine-Zellen, die die Filter abdecken, Zellen mit mindestens einer Antwort und die Differenz. |
| `partialDays` | UTC-Tage, die das Fenster anschneidet oder die noch nicht vorbei sind. Der niedrigere Zählwert eines Teiltags ist Arithmetik, kein Rückgang. |
| `noAnswerObservations` | Abgeschlossene Antworten ohne Text, als nicht genannt gezählt. |
| `unknownObservations` | Antworten, die bewertet wurden, bevor der Bewertungskontext gespeichert wurde. |
| `noAnswerIncluded`, `failedTasksIncluded`, `historicalFailures` | Immer `true`, `false` und `null`: Antworten ohne Text sind im Nenner, fehlgeschlagene Tasks nicht, und Fehlschläge werden nie aus der Historie rekonstruiert. |
| `denominator`, `shareOfVoiceDenominator` | `scored_answers` und `tracked_brand_mentions`. |
| `trackedBrandMentions` | Der Nenner des Share of Voice. |
| `answerTextLimit` | `8000`: Gespeicherter Antworttext wird bei 8.000 Zeichen gekürzt. |

### Laufzustand

`health` hat `completed`, `failed`, `pending` und `topError` (den häufigsten Fehlercode unter fehlgeschlagenen Tasks)
für die Tasks des Monitors, die laufen oder in den letzten 24 Stunden abgeschlossen wurden. `healthScope` ist immer
`recent_visible_tasks`. Es dient der Diagnose von Läufen, ist unabhängig vom Fenster und nie Teil des Nenners einer Quote.

## Während eines Laufs abfragen

Jeder Aufruf liefert den vollständigen Bericht für Fenster und Filter. Während ein Lauf läuft, zählt
`health.pending` seine noch laufenden Tasks. Lesen Sie den Bericht erneut, sobald der Wert 0 erreicht.

## Kategorie-Berichte

Ein [Kategorie-Monitor](/de/monitors.md#kategorie-monitore) liefert vom selben Endpunkt einen anderen Body, mit denselben
`window`, `filters`, `quality`, `pauses` und `health`:

* `stats` und `previous` enthalten `runs`, `named` (Antworten, die mindestens eine verfolgte Marke nannten) und
  `namedRate`. `changes.namedRatePp` ist die Veränderung in Punkten.
* `category` enthält das Ranking:

| Feld | Inhalt |
| - | - |
| `category.name` | Die `category` des Monitors. |
| `category.brands` | Jede verfolgte Marke und jede Marke, die die Antworten nannten, meiste Nennungen zuerst: `name`, `rank`, `mentions`, `sampleSize`, `mentionRate`, `shareOfVoice`, `previousMentionRate`, `previousShareOfVoice`, `changePp` und `configured`. |
| `category.topics` | Eine Zeile pro Teilbereich (`topic: null` ist die ganze Kategorie): `prompts`, `runs`, `named`, `namedRate` und `leaders`, die drei am häufigsten genannten Marken. |
| `category.engines` | Eine Zeile pro Engine mit Antworten im Fenster: `runs`, `named`, `namedRate` und `leaders`. |
| `category.series` | Pro UTC-Tag die fünf führenden verfolgten Marken: `mentions`, `sampleSize`, `runs`, `mentionRate` und `partial`. |
| `category.prompts` | Eine Zeile pro Prompt: `topic`, `retired` (`true` für einen Prompt, der nicht mehr am Monitor ist), `runs`, `named`, `namedRate`, `leaders` und `engines`, jeweils mit `runs`, `named` und einer `evidenceTaskId` für die neueste Antwort, die eine Marke nannte. |

Zum Beispiel ein Eintrag in `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`** ordnet Marken nach der Zahl der Antworten, die sie nennen. Eine Marke, die keine Antwort genannt hat, hat
  `rank: null`.
* **`mentionRate`** teilt durch die eigene `sampleSize` der Marke: die Antworten, die bewertet wurden, während sie auf
  der Liste stand.
* **`shareOfVoice`** ist `100 × Nennungen dieser Marke / alle Markennennungen` im Fenster, die Anteile ergeben also
  zusammen 100.

## Fehler und Limits

* Das Fenster beträgt höchstens 90 Tage.
* Ungültige Parameter liefern `400 VALIDATION_ERROR` mit einer Meldung, die das Problem nennt: `days` zusammen mit
  `since` oder `until`, nur eines von `since` und `until`, ein Zeitstempel ohne Zeitzone, eine Spanne über 90 Tage, ein
  `until` in der Zukunft, eine Engine, die nicht überwacht werden kann, ein Prompt über 2.000 Zeichen oder ein
  wiederholter Parameter.
* Ein Bericht, der zu groß zum Aggregieren ist, liefert `400 VALIDATION_ERROR` mit „This report is too large“. Schränken
  Sie Fenster, Engine oder Prompt ein.

Die Codes, die alle Monitor-Endpunkte teilen, stehen unter [Monitore](/de/monitors.md#fehler).

## Nächste Schritte

> **[Quellen und Antworten](/de/monitors/evidence.md)**
>
> Die zitierten Seiten und die Antworten hinter jeder Zahl.

> **[Ereignisse und Alarme](/de/monitors/events-and-alerts.md)**
>
> Benachrichtigt werden, wenn sich Antworten ändern.


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