> ## 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. # Antwortanalyse: Markennennungen, Rang, Sentiment und Quellenarten > Fügen Sie einem Antwort-Task include.analysis hinzu und erhalten Sie jede Marke, die die Antwort nennt, wie sie jede behandelt und welche Art von Website jede Quelle ist. Setzen Sie `payload.include.analysis` auf `true`, und der Task liefert neben der Antwort jede Marke, die sie nennt, in ihrer Reihenfolge, ob sie die Marke empfiehlt und wie sie über sie spricht, ob Ihre Marke und Ihre Wettbewerber vorkommen und welche Art von Website jede Quelle ist. Daraus berechnen Sie Erwähnungsrate, durchschnittliche Position, Sentiment, Share of Voice und Quellenanteil, ohne ein eigenes Modell über die Antwort laufen zu lassen. ## Anfrage ```bash theme={"theme":"css-variables"} curl -X POST https://api.querying.ai/v1/async/task \ -H "Authorization: Bearer $QUERYING_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "taskType": "CHATGPT", "payload": { "prompt": "best CRM for a small team", "country": "US", "include": { "analysis": true }, "brand": "Acme CRM", "brandAliases": ["Acme"], "brandDomains": ["acme-crm.example"], "competitors": ["Northwind", { "name": "Contoso CRM", "aliases": ["Contoso"], "domains": ["contoso-crm.example"] }] } }' ``` | Feld | Pflicht | Beschreibung | | - | - | - | | `include.analysis` | Ja | `true`, um die Analyse auszuführen. | | `brand` | Nein | Name Ihrer Marke, bis zu 200 Zeichen. Keine URL: Websites gehören in `brandDomains`. | | `brandAliases` | Nein | Bis zu 20 weitere Namen Ihrer Marke. Nur zusammen mit `brand`. | | `brandDomains` | Nein | Bis zu 20 Websites wie `acme-crm.example`. Eine Quelle auf der Website oder einer Subdomain gilt als Ihre. Nur zusammen mit `brand`. | | `competitors` | Nein | Bis zu 50 Wettbewerber. Jeder ist ein Name oder `{ name, aliases, domains }` mit bis zu 20 Aliasen und 20 Domains. | Jeder Name braucht mindestens zwei Zeichen oder einen Alias mit mindestens zwei Zeichen. Ohne `brand` und `competitors` listet die Analyse trotzdem jede Marke auf, die die Antwort nennt. ## Unterstützte Engines `CHATGPT`, `GEMINI`, `PERPLEXITY`, `GOOGLE`, `AIMODE`, `NAVER_AI_BRIEF` und `NAVER_AI_TAB` (und ihre Aliase). Bei einem `CHATGPT`-Task mit `followUps` liest die Analyse die erste Antwort. ## Credits Die Analyse kostet **1 Credit** pro Task zusätzlich zum Preis der Engine. Der Task reserviert ihn beim Einreichen und berechnet ihn nur, wenn `analysis.status` `ok` ist. Siehe [Credits und Limits](/de/concepts/credits-and-limits.md). ## Antwort Die `response` des Tasks erhält ein `analysis`-Objekt. Zum Beispiel: ```json theme={"theme":"css-variables"} { "analysis": { "version": 1, "status": "ok", "brands": [ { "name": "Northwind", "domain": null, "writtenAs": "Northwind", "spellings": ["Northwind"], "rank": 1, "role": "competitor", "recommended": true, "sentiment": "positive", "sentimentScore": 0.9 }, { "name": "Acme CRM", "domain": "acme-crm.example", "writtenAs": "Acme", "spellings": ["Acme", "Acme CRM"], "rank": 2, "role": "brand", "recommended": true, "sentiment": "positive", "sentimentScore": 0.5 }, { "name": "Fabrikam", "domain": "fabrikam.example", "writtenAs": "Fabrikam", "spellings": ["Fabrikam"], "rank": 3, "role": null, "recommended": false, "sentiment": "neutral", "sentimentScore": 0 } ], "targets": [ { "name": "Acme CRM", "role": "brand", "mentioned": true, "rank": 2, "recommended": true, "sentiment": "positive", "sentimentScore": 0.5, "cited": true }, { "name": "Northwind", "role": "competitor", "mentioned": true, "rank": 1, "recommended": true, "sentiment": "positive", "sentimentScore": 0.9, "cited": false }, { "name": "Contoso CRM", "role": "competitor", "mentioned": false, "rank": null, "recommended": null, "sentiment": null, "sentimentScore": null, "cited": false } ], "sources": [ { "position": 1, "url": "https://www.acme-crm.example/pricing", "domain": "acme-crm.example", "kind": "owned", "brand": "Acme CRM" }, { "position": 2, "url": "https://www.g2.com/categories/crm", "domain": "g2.com", "kind": "reviews", "brand": null } ] } } ``` | Feld | Beschreibung | | - | - | | `status` | `ok`, `no_answer` oder `failed`. Siehe [Status](#status). | | `brands` | Jede Marke, die die Antwort nennt, in der Reihenfolge ihrer ersten Nennung. Ein Produkt zählt für seinen Hersteller, "MacBook Air" ergibt also einen Rang für Apple. `rank` beginnt bei 1. `role` ist `brand` oder `competitor` für die gesendeten Marken und `null` für die übrigen. | | `brands[].name`, `domain`, `writtenAs`, `spellings` | Für Ihre Marke und Ihre Wettbewerber ist `name` der Name, den Sie gesendet haben. Für jede andere Marke ist es der eigene Name der Marke, in jeder Sprache derselbe: ihr offizieller Name in lateinischer Schrift oder, wenn es keinen gibt, ihr ursprünglicher Name. 마켓컬리 und 컬리 sind beide `Kurly`. `domain` ist die Website der Marke: die erste der gesendeten Domains, die für sie gefundene oder `null`. `spellings` enthält jede Schreibweise, mit der die Antwort den Namen der Marke schreibt, in der Reihenfolge ihres ersten Auftretens, für Baemin also 배민 und 배달의민족. Ein Produkt oder eine Beschreibung nach dem Namen gehört nicht zur Schreibweise. `writtenAs` ist die erste davon. | | `targets` | Die gesendeten Marken in Ihrer Reihenfolge, jeweils mit `mentioned` und ihrem `rank` in `brands`. `cited` ist `true`, wenn eine Quelle auf einer ihrer Domains liegt, und `false`, wenn Sie keine Domains gesendet haben. | | `recommended` | Die Antwort empfiehlt die Marke oder stellt sie als gute Wahl dar. | | `sentiment`, `sentimentScore` | Die Haltung der Antwort zur Marke in fünf Stufen mit den Werten 0.9, 0.5, 0, -0.5 und -0.9. Lob oder Kritik an anderen Marken zählt nicht, und eine Empfehlung oder Warnung wiegt schwerer als beiläufige Bemerkungen. | | `sources[].kind` | `owned` und `competitor` ergeben sich aus den gesendeten Domains. Bekannte Websites folgen festen Listen: `editorial` (Nachrichten und Magazine), `review_media` (Produkttest- und Testmagazine), `pr_wire`, `reviews` (Bewertungsportale von Nutzern), `commerce`, `social` (soziale Netzwerke), `blog` (Blogplattformen), `community` (Foren, Q\&A und Wikis), `video` und `institution` (Behörden und Hochschulen). Jede andere Website stuft ein Modell einmal ein, und das Ergebnis wird wiederverwendet: `brand` (die eigene Website eines Unternehmens), `content` (eine unabhängige Website oder ein privater Blog) oder einer der Typen oben. `other` bleibt für Websites, die zu keinem Typ passen, etwa Suchmaschinen und Tools, oder die nicht eingestuft werden konnten. | ## Wie entschieden wird * Welche Namen Marken sind, welche davon Ihre ist, `recommended` und `sentiment` beurteilt ein Modell. Positionen, Ränge, der Abgleich der Namen und die Quellenarten werden nach Regeln berechnet, sodass dieselbe Modellbewertung dasselbe Ergebnis liefert. * Ihre Marke und Ihre Wettbewerber werden über Namen und Aliase nach denselben Regeln gefunden wie bei einem [Monitor](/de/monitors.md#wie-namen-erkannt-werden): in lateinischer Schrift als ganze Wörter, auf Koreanisch, Japanisch, Chinesisch und Thai an jeder Stelle, nie innerhalb eines Quellenlinks. Das Modell verbindet auch andere Schreibweisen, die es findet. Eine Schreibweise, die es als Namen der Marke selbst bestätigt, etwa 컬리 für Kurly, wird gespeichert und in späteren Antworten nach den Regeln gefunden. Ein Name, der nicht in der Antwort steht, wird nie gemeldet. * Passt Ihr Name, liest das Modell ihn in dieser Antwort aber nicht als Marke (ein gewöhnliches Wort in anderer Bedeutung), wird die Marke mit `recommended`, `sentiment` und `sentimentScore` auf `null` aufgeführt. * Für jede Marke, die Sie nicht gesendet haben, legt ein Modell den Namen fest, sobald eine Antwort die Schreibweise zum ersten Mal verwendet. Name und Website gelten dann für alle späteren Antworten. Bereits benannte Marken mit einer zitierten Website oder ähnlicher Schreibweise werden mitgegeben, damit eine Filiale oder eine andere Schrift denselben Namen erhält. Schlägt die Benennung fehl, behält die Marke die Schreibweise der Antwort und `domain` ist `null`. * Eine Website ist eine Marke: Marken mit derselben Website erscheinen einmal, unter dem eigenen Namen der Website (Baemin für baemin.com) oder sonst dem Namen, den sie zuerst erhielt, daher sind 아임웹 und I'mweb eine Marke, und eine Marke auf der Website einer gesendeten Marke ist diese Marke. Ein Beitrag auf einer Blog-, Community-, Video- oder Social-Media-Plattform wird keiner nicht gesendeten Marke zugeordnet, auch nicht auf deren eigener Plattform wie blog.naver.com für NAVER. * Ein Name, den das Modell nicht als Marke liest, etwa ein allgemeines Wort, ein Ort oder eine Behandlung, entfällt. Marken, die eine Antwort als einen Namen schreibt, etwa „마켓컬리, 오아시스마켓, SSG닷컴“, zählen jeweils als eigene Marke, und eine Beschreibung nach einem Namen gehört nicht dazu. * Das Modell liest die ersten 40.000 Zeichen der Antwort. Eine Marke, die erst danach genannt wird, wird nicht gemeldet. * Die Analyse verzögert den Abschluss des Tasks um einige Sekunden. ## Status | `status` | Bedeutung | Berechnet | | - | - | - | | `ok` | Die Analyse ist gelaufen. | 1 Credit | | `no_answer` | Die Engine hat ohne Antworttext abgeschlossen, etwa eine Google-Suche ohne AI Overview. Keine gesendete Marke gilt als erwähnt. | Nein | | `failed` | Die Analyse konnte nicht laufen. `error` ist `ANALYSIS_FAILED`, `ANALYSIS_TIMEOUT` oder `ANALYSIS_UNAVAILABLE`. Der Task wird trotzdem mit seiner Antwort abgeschlossen. | Nein | ## Fehler | Status | Code | Wann | | - | - | - | | `422` | `VALIDATION_ERROR` | `include.analysis` ist kein Boolean, die Engine unterstützt keine Analyse, oder `brand`, `brandAliases`, `brandDomains` oder `competitors` verletzt die Regeln oben. `details[].field` nennt das Feld. | ## Verwandt * [Markdown und Rohantworten](/de/engines/response-options.md) * [GEO-Monitoring](/de/monitors.md): dieselbe Analyse nach Zeitplan ausführen. * [Engine-Übersicht](/de/engines/overview.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.