Options de réponse : Markdown, réponses brutes et flags include

payload.include ajoute des champs facultatifs à la réponse d’une tâche. Chaque flag est un booléen, et chaque moteur n’en respecte que certains.

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

Flags

Flag	Ajoute
`markdown`	La réponse en Markdown, dans `markdown` (`aioverview.markdown` sur `GOOGLE` et `BING_SEARCH`).
`rawResponse`	La sortie brute du moteur, dans `rawResponse` ou `rawContent` (voir plus bas).
`searchQueries`	Les recherches lancées par le moteur, dans `searchQueries`.
`ads`, `shopping`	Les annonces et les fiches produit. `CHATGPT` uniquement.
`html`	L’écran affiché par le moteur. Voir Pages HTML.
`analysis`	Les marques, recommandations, sentiments et types de source. Voir Analyse de la réponse.
`entityDetails`	Le panneau de détail de chaque carte de la réponse, gratuit. `CHATGPT` uniquement. Voir ChatGPT.
`citationAnalysis`	Une Citation Analysis de la réponse. Voir plus bas.

Matrice de prise en charge

✓ respecté, toujours renvoyé sans le flag, — sans effet (ignoré), ✗ refusé.

taskType	`markdown`	`rawResponse`	`searchQueries`	`html`	`analysis`	`citationAnalysis`
`CHATGPT`	✓ (activé par défaut)	✓	✓ (activé par défaut)	✓	✓	✓
`GEMINI`	✓	✓	—	✓	✓	✓
`PERPLEXITY`	✓	✓	✓	✓	✓	✓
`GOOGLE`	✓	✓ `rawContent`	—	✓	✓	✓
`AIMODE`	toujours	✓ `rawContent`	—	✓	✓	✓
`BING_COPILOT`	✓	✓	toujours	✗	✗	✓
`NAVER_AI_BRIEF`	toujours	✓ `rawContent`	—	✗	✓	✓
`NAVER_AI_TAB`	toujours	✓ `rawContent`	—	✗	✓	✓
`META_AI`	toujours	✓	toujours	✓	✗	✗
`QWEN`	toujours	✓	toujours	✗	✗	✗
`DOUBAO`	toujours	✓	toujours	✗	✗	✗
`GOOGLE_SERP`	—	✓ `rawContent`	—	✗	✗	✗
`BING_SEARCH`	✓	✓ `rawContent`	—	✗	✗	✓
`NAVER_SERP`, `COMMERCE_SERP`, `COMMERCE_PRODUCT`, `REDDIT`, `WEB_SCRAPE`, `WEB_MAP`, `WEB_CRAWL`, `KEYWORD_VOLUME`	—	—	—	✗	✗	✗

ads et shopping ne fonctionnent que sur CHATGPT, où ils sont activés par défaut ; les autres moteurs les ignorent. « toujours » pour searchQueries signifie que le moteur renvoie le champ que vous définissiez le flag ou non.

Markdown sans flag

AIMODE, NAVER_AI_BRIEF, NAVER_AI_TAB, META_AI, QWEN et DOUBAO renvoient markdown à chaque réponse. Pour ces moteurs, le Markdown est la vraie forme de la réponse (titres, listes, tableaux et cartes en place), et non une copie de text. CHATGPT le renvoie aussi par défaut ; envoyez "markdown": false pour l’omettre. GOOGLE accepte aussi l’ancien flag include.aioverview.markdown, qui fait la même chose que include.markdown.

Réponses brutes

rawResponse est désactivé par défaut sur tous les moteurs, CHATGPT compris. La sortie brute arrive dans l’un de deux champs :

rawResponse : un tableau d’événements de flux analysés (CHATGPT, GEMINI, PERPLEXITY, BING_COPILOT, META_AI, QWEN, DOUBAO).
rawContent : une chaîne. Pour GOOGLE, AIMODE, GOOGLE_SERP et BING_SEARCH, c’est le HTML complet de la page de résultats rendue ; pour NAVER_AI_BRIEF et NAVER_AI_TAB, c’est le flux d’événements d’origine de Naver.

Ces champs peuvent atteindre plusieurs centaines de Ko : ne les demandez que si vous en avez besoin.

Flags non pris en charge

Le comportement dépend du flag :

Flag	Sur un moteur qui ne le prend pas en charge
`markdown`, `rawResponse`, `searchQueries`, `ads`, `shopping`	Ignoré silencieusement. Ni erreur, ni champ.
`html`	`422 EVIDENCE_UNSUPPORTED`.
`analysis`	`422 VALIDATION_ERROR` sur `payload.include.analysis`.
`citationAnalysis`	`400 VALIDATION_ERROR` sur `payload.include.citationAnalysis`.
`entityDetails`	`422 VALIDATION_ERROR` sur `payload.include.entityDetails`.
`screenshot`	`400 VALIDATION_ERROR` sur tous les moteurs. Il n’est plus disponible ; utilisez `html`.

html, screenshot et citationAnalysis doivent être des booléens (400 VALIDATION_ERROR sinon), tout comme analysis (422 VALIDATION_ERROR). Tous les refus ont lieu à l’envoi, avant toute réservation de crédits.

Citation Analysis

include.citationAnalysis: true lance une Citation Analysis de la réponse une fois celle-ci terminée. C’est une tâche distincte et facturée ; le webhook de la réponse l’attend, et les lectures l’intègrent sous response.citationAnalysis. Elle fonctionne sur CHATGPT, GEMINI, PERPLEXITY, GOOGLE, AIMODE, BING_SEARCH, BING_COPILOT, NAVER_AI_BRIEF et NAVER_AI_TAB. La clé d’API doit aussi être autorisée à envoyer CITATION_ANALYSIS (403 sinon). Voir Citation Analysis pour le résultat et son prix.

Premiers pas

Concepts clés

Moteurs de réponse

Recherche et données web

Options de requête

Analyses

Suivi GEO

Compte et données

Options de réponse : Markdown, réponses brutes et flags include

Flags

Matrice de prise en charge

Markdown sans flag

Réponses brutes

Flags non pris en charge

Citation Analysis

Voir aussi

​Flags

​Matrice de prise en charge

​Markdown sans flag

​Réponses brutes

​Flags non pris en charge

​Citation Analysis

​Voir aussi

Flags

Matrice de prise en charge

Markdown sans flag

Réponses brutes

Flags non pris en charge

Citation Analysis

Voir aussi