Recibe la pantalla que mostró cada motor de IA con su respuesta

Activa include.html en ChatGPT, Gemini, Perplexity, Meta AI, Google AI Overviews o AI Mode y recibe un enlace a la pantalla de respuesta del propio motor, guardada como una página que se abre sin clave de API.

Qué obtienes

• payload.include.html: true en CHATGPT, GEMINI, PERPLEXITY, META_AI, GOOGLE y AIMODE.
• html en la respuesta: status (ok o failed), url y expiresAt. El enlace funciona 30 días después de terminar la tarea.
• La página se abre sin clave de API y no carga nada de fuera, así que puedes enlazarla o incrustarla en un informe.
• Los campos de la respuesta (text, sources y el resto) llegan como antes. Si la página falla, la tarea no falla.

Cómo funciona

En ChatGPT, Gemini, Perplexity y Meta AI, la pregunta se hace en un navegador real en el sitio del propio motor, y la pantalla se guarda cuando termina la respuesta: la barra lateral, la pregunta, la respuesta con sus fuentes y el cuadro de mensaje. Los campos de la respuesta salen de esa misma pregunta, y una pantalla que no coincide con la respuesta no se guarda.

Antes de guardar se quitan los scripts, y las imágenes, estilos y fuentes quedan dentro del archivo. La página se abre igual en cualquier navegador, sin cargar nada del motor.

En Google AI Overviews y AI Mode, la página es la de resultados que Google devolvió para la tarea, sin sus scripts. El AI Overview y su lista de fuentes se guardan abiertos, como si se hubiera pulsado Mostrar más y Mostrar todo, así que la respuesta completa se lee sin scripts.

Si la pantalla no se puede capturar o guardar, html es { "status": "failed", "error": "EVIDENCE_FAILED" } y la tarea termina con su respuesta. Una tarea de ChatGPT con location, CN, HK o continueFrom, y una de Gemini con location, CN, DE, GB o IR, siempre vuelven sin página.

Para qué sirve

• Pon la pantalla del propio motor junto a cada cifra de un informe para un cliente, para que vea la respuesta tal como la vio un usuario.
• Abre la página cuando un resultado procesado parezca raro y mira dónde aparecían la marca o la fuente en pantalla.
• Guarda un registro fechado de lo que respondió cada motor. Las páginas duran 30 días, así que descarga las que necesites por más tiempo.

Envía la solicitud

Envía la solicitud con tu clave de API en la cabecera Authorization.

curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "taskType": "PERPLEXITY",
    "payload": {
      "prompt": "What are the best CRM tools for a 10-person startup?",
      "country": "US",
      "include": { "html": true }
    }
  }'

Campos de la solicitud

taskTypestringObligatorio

El motor que se ejecuta, como CHATGPT o GOOGLE.

payload.promptstringObligatorio

La pregunta, escrita como la teclea un usuario en el chat. Hasta 100.000 caracteres.

payload.countrystring

Código de país de dos letras del mercado desde el que se pregunta, como US, KR o JP. Por defecto US.

payload.include.htmlboolean

Con true se añade html, un enlace a la pantalla que mostró el motor con la respuesta. En CHATGPT, GEMINI, PERPLEXITY, META_AI, GOOGLE y AIMODE. Desactivado por defecto.

webhook.urlstring

Una dirección HTTPS de tu servidor. La tarea terminada se envía allí en cuanto se completa.

Respuesta

Así llega una tarea terminada, recortada para que se lea mejor.

{
  "success": true,
  "task": {
    "id": "7be8662e-5f62-48bf-a54a-7b58a2701b7c",
    "taskType": "PERPLEXITY",
    "status": "COMPLETED",
    "createdAt": "2026-10-21T01:20:07.445Z"
  },
  "credits": { "creditsToCharge": 1.25, "creditsCharged": 1.25 },
  "response": {
    "text": "For a 10-person startup, the strongest shortlist is **HubSpot** for a free, easy starting point; **Pipedrive** for a straightforward sales pipeline; **Zoho CRM** for budget-friendly customization; and **Attio** for a flexible, data-driven CRM.[1][2][3]\n\n…",
    "sources": [
      {
        "position": 1,
        "url": "https://slack.com/blog/crm/best-crms-for-startups",
        "label": "Best CRMs for Startups: Tools, Benefits, and Tips"
      },
      {
        "position": 2,
        "url": "https://attio.com/f/best-crm-for-startups",
        "label": "Best CRMs for startups in 2026"
      }
    ],
    "html": {
      "status": "ok",
      "url": "https://api.querying.ai/v1/evidence/1792545851-e8cc8a32dd7f456eb807a0e09e9bc0fa.html",
      "expiresAt": "2026-11-20T01:24:11.000Z"
    }
  }
}

task.statusstring

QUEUED, PROCESSING y al final COMPLETED con la respuesta o FAILED con error.

credits.creditsChargedinteger

Créditos cobrados por la tarea terminada. Una tarea fallida cobra 0.

response.textstring

La respuesta en texto plano.

response.sourcesarray

Las páginas que cita la respuesta, en el orden del motor, con position, url y label.

response.htmlobject

La pantalla del motor: status (ok o failed), url (se abre sin clave de API) y expiresAt, 30 días después de terminar la tarea. Si la página falla, trae error EVIDENCE_FAILED y la tarea igual termina con su respuesta.

Recibe el resultado

La solicitud devuelve la tarea al instante con status QUEUED. Consulta GET /v1/async/task/{id} hasta que status sea COMPLETED o FAILED, o añade webhook.url y la tarea terminada llega a tu servidor con los mismos task, credits y response. Los resultados siguen disponibles 24 horas después de terminar la tarea.

curl https://api.querying.ai/v1/async/task/$TASK_ID \
  -H "Authorization: Bearer $QUERYING_API_KEY"

Errores

EVIDENCE_UNSUPPORTEDHTTP 422

include.html está activado en un motor que no tiene página. Solo CHATGPT, GEMINI, PERPLEXITY, META_AI, GOOGLE y AIMODE la devuelven.

VALIDATION_ERRORHTTP 400

Falta un campo o su valor está fuera de rango. details indica el campo.

MISSING_API_KEYHTTP 401

Falta la cabecera Authorization, o su clave es desconocida, caducó o fue revocada.

INSUFFICIENT_CREDITSHTTP 402

El saldo es menor que el precio de la tarea. Añade créditos o mejora el plan y vuelve a enviarla.

Precio

En ChatGPT, Perplexity y Meta AI, la página suma 0,25 créditos al precio del motor. Esos 0,25 se reservan al enviar y solo se cobran cuando html.status es ok. En Gemini, Google AI Overviews y AI Mode, la página es gratis. Con la página, una tarea en cualquiera de los seis motores cuesta 1,25 créditos, como la tarea de Perplexity del ejemplo.