Antwortoptionen: Markdown, Rohantworten und include-Flags

payload.include fügt der Antwort eines Tasks optionale Felder hinzu. Jedes Flag ist ein Boolean, und jede Engine berücksichtigt nur einige davon.

{
  "taskType": "PERPLEXITY",
  "payload": {
    "prompt": "best CRM for a small team",
    "country": "US",
    "include": { "markdown": true, "rawResponse": true }
  }
}

Flags

Flag	Fügt hinzu
`markdown`	Die Antwort als Markdown in `markdown` (`aioverview.markdown` bei `GOOGLE` und `BING_SEARCH`).
`rawResponse`	Die Rohausgabe der Engine als `rawResponse` oder `rawContent` (siehe unten).
`searchQueries`	Die Suchen, die die Engine ausgeführt hat, in `searchQueries`.
`ads`, `shopping`	Anzeigen und Produktkarten. Nur `CHATGPT`.
`html`	Den Bildschirm, den die Engine gezeigt hat. Siehe HTML-Seiten.
`analysis`	Marken, Empfehlungen, Sentiment und Quellenarten. Siehe Antwortanalyse.
`entityDetails`	Den Detailbereich jeder Karte der Antwort, kostenlos. Nur `CHATGPT`. Siehe ChatGPT.
`citationAnalysis`	Eine Citation Analysis der Antwort. Siehe unten.

Support-Matrix

✓ berücksichtigt, immer auch ohne Flag geliefert, — keine Wirkung (ignoriert), ✗ abgelehnt.

taskType	`markdown`	`rawResponse`	`searchQueries`	`html`	`analysis`	`citationAnalysis`
`CHATGPT`	✓ (standardmäßig an)	✓	✓ (standardmäßig an)	✓	✓	✓
`GEMINI`	✓	✓	—	✓	✓	✓
`PERPLEXITY`	✓	✓	✓	✓	✓	✓
`GOOGLE`	✓	✓ `rawContent`	—	✓	✓	✓
`AIMODE`	immer	✓ `rawContent`	—	✓	✓	✓
`BING_COPILOT`	✓	✓	immer	✗	✗	✓
`NAVER_AI_BRIEF`	immer	✓ `rawContent`	—	✗	✓	✓
`NAVER_AI_TAB`	immer	✓ `rawContent`	—	✗	✓	✓
`META_AI`	immer	✓	immer	✓	✗	✗
`QWEN`	immer	✓	immer	✗	✗	✗
`DOUBAO`	immer	✓	immer	✗	✗	✗
`GOOGLE_SERP`	—	✓ `rawContent`	—	✗	✗	✗
`BING_SEARCH`	✓	✓ `rawContent`	—	✗	✗	✓
`NAVER_SERP`, `COMMERCE_SERP`, `COMMERCE_PRODUCT`, `REDDIT`, `WEB_SCRAPE`, `WEB_MAP`, `WEB_CRAWL`, `KEYWORD_VOLUME`	—	—	—	✗	✗	✗

ads und shopping wirken nur bei CHATGPT, wo sie standardmäßig aktiviert sind; alle anderen Engines ignorieren sie. „immer“ bei searchQueries bedeutet, dass die Engine das Feld liefert, ob Sie das Flag setzen oder nicht.

Markdown ohne Flag

AIMODE, NAVER_AI_BRIEF, NAVER_AI_TAB, META_AI, QWEN und DOUBAO liefern markdown bei jeder Antwort. Bei diesen Engines ist Markdown die eigentliche Form der Antwort (Überschriften, Listen, Tabellen und Karten an ihrer Stelle) und keine Kopie von text. CHATGPT liefert es ebenfalls standardmäßig; senden Sie "markdown": false, um es wegzulassen. GOOGLE akzeptiert außerdem das ältere Flag include.aioverview.markdown, das dasselbe bewirkt wie include.markdown.

Rohantworten

rawResponse ist bei jeder Engine standardmäßig deaktiviert, auch bei CHATGPT. Rohausgaben kommen in einem von zwei Feldern:

rawResponse: ein Array geparster Stream-Ereignisse (CHATGPT, GEMINI, PERPLEXITY, BING_COPILOT, META_AI, QWEN, DOUBAO).
rawContent: ein String. Bei GOOGLE, AIMODE, GOOGLE_SERP und BING_SEARCH ist es das vollständige gerenderte HTML der Ergebnisseite; bei NAVER_AI_BRIEF und NAVER_AI_TAB Navers ursprünglicher Ereignis-Stream.

Diese Felder können Hunderte Kilobyte groß sein; fordern Sie sie nur an, wenn Sie sie brauchen.

Nicht unterstützte Flags

Was passiert, hängt vom Flag ab:

Flag	Bei einer Engine, die es nicht unterstützt
`markdown`, `rawResponse`, `searchQueries`, `ads`, `shopping`	Stillschweigend ignoriert. Kein Fehler und kein Feld.
`html`	`422 EVIDENCE_UNSUPPORTED`.
`analysis`	`422 VALIDATION_ERROR` zu `payload.include.analysis`.
`citationAnalysis`	`400 VALIDATION_ERROR` zu `payload.include.citationAnalysis`.
`entityDetails`	`422 VALIDATION_ERROR` zu `payload.include.entityDetails`.
`screenshot`	`400 VALIDATION_ERROR` bei jeder Engine. Nicht mehr verfügbar; nutzen Sie `html`.

html, screenshot und citationAnalysis müssen Booleans sein (sonst 400 VALIDATION_ERROR), ebenso analysis (422 VALIDATION_ERROR). Alle Ablehnungen erfolgen beim Einreichen, bevor Credits reserviert werden.

Citation Analysis

include.citationAnalysis: true startet eine Citation Analysis der Antwort, sobald diese abgeschlossen ist. Sie ist ein separater, abgerechneter Task, der Webhook der Antwort wartet auf sie, und Abrufe enthalten sie unter response.citationAnalysis. Sie funktioniert mit CHATGPT, GEMINI, PERPLEXITY, GOOGLE, AIMODE, BING_SEARCH, BING_COPILOT, NAVER_AI_BRIEF und NAVER_AI_TAB. Der API-Schlüssel muss außerdem CITATION_ANALYSIS einreichen dürfen (sonst 403). Ergebnis und Preis stehen unter Citation Analysis.

Erste Schritte

Grundlagen

Antwort-Engines

Suche und Webdaten

Anfrageoptionen

Recherche

GEO-Monitoring

Konto und Daten

Antwortoptionen: Markdown, Rohantworten und include-Flags

Flags

Support-Matrix

Markdown ohne Flag

Rohantworten

Nicht unterstützte Flags

Citation Analysis

Verwandt

​Flags

​Support-Matrix

​Markdown ohne Flag

​Rohantworten

​Nicht unterstützte Flags

​Citation Analysis

​Verwandt

Flags

Support-Matrix

Markdown ohne Flag

Rohantworten

Nicht unterstützte Flags

Citation Analysis

Verwandt