Opciones de respuesta: Markdown, respuestas en bruto y flags include

payload.include añade campos opcionales a la respuesta de una tarea. Cada flag es un booleano, y cada motor respeta solo algunos.

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

Flags

Flag	Añade
`markdown`	La respuesta en Markdown, en `markdown` (`aioverview.markdown` en `GOOGLE` y `BING_SEARCH`).
`rawResponse`	La salida en bruto del motor, como `rawResponse` o `rawContent` (consulta abajo).
`searchQueries`	Las búsquedas que ejecutó el motor, en `searchQueries`.
`ads`, `shopping`	Anuncios y tarjetas de producto. Solo `CHATGPT`.
`html`	La pantalla que mostró el motor. Consulta Páginas HTML.
`analysis`	Marcas, recomendaciones, sentimiento y tipos de fuente. Consulta Análisis de la respuesta.
`entityDetails`	El panel de detalle de cada tarjeta de la respuesta, gratis. Solo `CHATGPT`. Consulta ChatGPT.
`citationAnalysis`	Un Citation Analysis de la respuesta. Consulta abajo.

Matriz de compatibilidad

✓ respetado, always devuelto sin el flag, — sin efecto (se ignora), ✗ rechazado.

taskType	`markdown`	`rawResponse`	`searchQueries`	`html`	`analysis`	`citationAnalysis`
`CHATGPT`	✓ (activado por defecto)	✓	✓ (activado por defecto)	✓	✓	✓
`GEMINI`	✓	✓	—	✓	✓	✓
`PERPLEXITY`	✓	✓	✓	✓	✓	✓
`GOOGLE`	✓	✓ `rawContent`	—	✓	✓	✓
`AIMODE`	always	✓ `rawContent`	—	✓	✓	✓
`BING_COPILOT`	✓	✓	always	✗	✗	✓
`NAVER_AI_BRIEF`	always	✓ `rawContent`	—	✗	✓	✓
`NAVER_AI_TAB`	always	✓ `rawContent`	—	✗	✓	✓
`META_AI`	always	✓	always	✓	✗	✗
`QWEN`	always	✓	always	✗	✗	✗
`DOUBAO`	always	✓	always	✗	✗	✗
`GOOGLE_SERP`	—	✓ `rawContent`	—	✗	✗	✗
`BING_SEARCH`	✓	✓ `rawContent`	—	✗	✗	✓
`NAVER_SERP`, `COMMERCE_SERP`, `COMMERCE_PRODUCT`, `REDDIT`, `WEB_SCRAPE`, `WEB_MAP`, `WEB_CRAWL`, `KEYWORD_VOLUME`	—	—	—	✗	✗	✗

ads y shopping solo funcionan en CHATGPT, donde están activados por defecto; los demás motores los ignoran. searchQueries marcado como “always” significa que el motor devuelve el campo tanto si pones el flag como si no.

Markdown sin flag

AIMODE, NAVER_AI_BRIEF, NAVER_AI_TAB, META_AI, QWEN y DOUBAO devuelven markdown en cada respuesta. Para estos motores, el Markdown es la forma real de la respuesta (títulos, listas, tablas y tarjetas en su sitio), no una copia de text. CHATGPT también lo devuelve por defecto; envía "markdown": false para quitarlo. GOOGLE también acepta el flag antiguo include.aioverview.markdown, que hace lo mismo que include.markdown.

Respuestas en bruto

rawResponse está desactivado por defecto en todos los motores, incluido CHATGPT. La salida en bruto llega en uno de dos campos:

rawResponse: un array de eventos de stream ya parseados (CHATGPT, GEMINI, PERPLEXITY, BING_COPILOT, META_AI, QWEN, DOUBAO).
rawContent: una cadena. En GOOGLE, AIMODE, GOOGLE_SERP y BING_SEARCH es el HTML completo de la página de resultados renderizada; en NAVER_AI_BRIEF y NAVER_AI_TAB es el stream de eventos original de Naver.

Estos campos pueden ocupar cientos de kilobytes, así que pídelos solo cuando los necesites.

Flags no admitidos

Lo que ocurre depende del flag:

Flag	En un motor que no lo admite
`markdown`, `rawResponse`, `searchQueries`, `ads`, `shopping`	Se ignora en silencio. Sin error y sin campo.
`html`	`422 EVIDENCE_UNSUPPORTED`.
`analysis`	`422 VALIDATION_ERROR` en `payload.include.analysis`.
`citationAnalysis`	`400 VALIDATION_ERROR` en `payload.include.citationAnalysis`.
`entityDetails`	`422 VALIDATION_ERROR` en `payload.include.entityDetails`.
`screenshot`	`400 VALIDATION_ERROR` en todos los motores. Ya no está disponible; usa `html`.

html, screenshot y citationAnalysis deben ser booleanos (400 VALIDATION_ERROR en otro caso), igual que analysis (422 VALIDATION_ERROR). Todos los rechazos ocurren al enviar, antes de reservar ningún crédito.

Citation Analysis

include.citationAnalysis: true inicia un Citation Analysis de la respuesta cuando esta se completa. Es una tarea aparte y medida: el webhook de la respuesta la espera, y las lecturas la incluyen en response.citationAnalysis. Funciona en CHATGPT, GEMINI, PERPLEXITY, GOOGLE, AIMODE, BING_SEARCH, BING_COPILOT, NAVER_AI_BRIEF y NAVER_AI_TAB. La clave de API también debe tener permiso para enviar CITATION_ANALYSIS (403 en otro caso). Consulta Citation Analysis para ver el resultado y su precio.

Primeros pasos

Conceptos clave

Motores de respuesta

Búsqueda y datos web

Opciones de solicitud

Investigación

Monitorización GEO

Cuenta y datos

Opciones de respuesta: Markdown, respuestas en bruto y flags include

Flags

Matriz de compatibilidad

Markdown sin flag

Respuestas en bruto

Flags no admitidos

Citation Analysis

Relacionado

​Flags

​Matriz de compatibilidad

​Markdown sin flag

​Respuestas en bruto

​Flags no admitidos

​Citation Analysis

​Relacionado

Flags

Matriz de compatibilidad

Markdown sin flag

Respuestas en bruto

Flags no admitidos

Citation Analysis

Relacionado