Las tarjetas de ChatGPT llegan con su panel de detalle

Activa include.entityDetails en una tarea de ChatGPT y recibe, sin coste extra, el panel que ChatGPT abre para cada tarjeta de producto, lugar o marca de la respuesta, con su texto, fuentes e imágenes.

Qué obtienes

• payload.include.entityDetails: true en tareas CHATGPT.
• entityDetails en la respuesta y en cada respuesta de followUps: una entrada por cada tarjeta que nombra la respuesta, hasta 20.
• Cada entrada tiene name, category (product, local_business, software, organization, brand y otras), query, status, markdown, sources, products, images y complete.
• sources lista los sitios que cita el panel, con position, url, label, site y description.

Cómo funciona

Cuando un usuario pulsa una tarjeta de producto, lugar o marca en una respuesta de ChatGPT, ChatGPT abre un panel y escribe un perfil breve citando los sitios que leyó. Al terminar la respuesta, se pide ese mismo panel para cada tarjeta, en la misma conversación, de cuatro en cuatro. El paso de detalle suma unos 10 segundos a cada respuesta.

markdown es el panel tal como lo escribió ChatGPT, con sus títulos, listas y enlaces a fuentes. complete: false indica que ChatGPT dejó de escribir antes de terminar el panel; el texto y las fuentes escritos hasta ese momento se conservan.

Cada tarjeta se procesa por separado. Una tarjeta que falla trae status: "failed" y un error (ENTITY_DETAIL_FAILED o ENTITY_DETAIL_EMPTY), y la respuesta y las demás tarjetas terminan como siempre. En tareas con location, CN o HK, las tarjetas vuelven con ENTITY_DETAIL_UNAVAILABLE.

include.entityDetails funciona en CHATGPT y se usa sin include.html. Si lo envías a otro motor o junto con include.html, la API devuelve 422 VALIDATION_ERROR antes de reservar créditos.

Para qué sirve

• Lee cómo describe ChatGPT tu producto cuando un comprador pulsa su tarjeta y revisa las especificaciones, precios y afirmaciones que repite.
• Mira qué sitios cita ChatGPT para tu producto y para cada competidor, y planifica reseñas y fichas en torno a ellos.
• Haz la misma pregunta en varios países y compara cómo presenta el panel de cada mercado a la misma marca.

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": "CHATGPT",
    "payload": {
      "prompt": "What is the best robot vacuum for pet hair?",
      "country": "US",
      "include": { "entityDetails": 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.entityDetailsboolean

Con true se añade entityDetails: el panel de detalle que ChatGPT abre para cada tarjeta de la respuesta. En CHATGPT, sin include.html. Desactivado por defecto, sin créditos extra.

payload.followUpsarray

Hasta 4 turnos más en la misma conversación de ChatGPT tras la primera respuesta. Cada elemento es {"prompt": "…"} para hacer una pregunta o {"select": {…}} para pulsar un botón del formulario de la respuesta anterior. Para CHATGPT.

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": "a81e4b26-b4c0-48eb-b20b-10efbd327f1a",
    "taskType": "CHATGPT",
    "status": "COMPLETED",
    "createdAt": "2026-10-21T04:40:09.819Z"
  },
  "response": {
    "text": "For most pet owners, I’d start with the **Dreame L40 Ultra Gen 2**. It offers a strong mix of pet-hair pickup, anti-tangle features, automatic dust emptying, and minimal day-to-day maintenance without necessarily requiring a flagship-level budget. …",
    "model": "gpt-6",
    "entityDetails": [
      "…",
      {
        "name": "Roborock Saros 20",
        "category": "product",
        "query": "Roborock Saros 20",
        "status": "ok",
        "markdown": "The **Roborock Saros 20** is Roborock's 2026 flagship robot vacuum and mop. It focuses on high-end automation with powerful vacuuming, dual spinning mop pads, advanced obstacle avoidance, an ultra-slim body for cleaning under furniture, and a dock that automates most maintenance tasks. …",
        "sources": [],
        "images": [],
        "complete": true
      },
      {
        "name": "MOVA P50 Pro Ultra",
        "category": "product",
        "query": "MOVA P50 Pro Ultra",
        "status": "ok",
        "markdown": "## MOVA P50 Pro Ultra\n\nThe **MOVA P50 Pro Ultra** is a premium robot vacuum and mop introduced as MOVA's 2025 flagship model. … ([RTINGS.com +1](https://www.rtings.com/robot-vacuum/reviews/mova/p50-pro-ultra-robot-vacuum?utm_source=chatgpt.com))\n\n### Key features\n\n- **19,000 Pa suction power**\n- **Dual rotating mop pads**\n…",
        "sources": [
          {
            "position": 1,
            "url": "https://www.rtings.com/robot-vacuum/reviews/mova/p50-pro-ultra-robot-vacuum?utm_source=chatgpt.com",
            "label": "MOVA P50 Pro Ultra Review - RTINGS.com",
            "site": "RTINGS.com"
          },
          {
            "position": 2,
            "url": "https://us.mova.tech/products/mova-p50-pro-ultra-robot-vacuum?utm_source=chatgpt.com",
            "label": "MOVA P50 Pro Ultra Robot Vacuum and Mop Combo | MOVA US",
            "site": "MOVA-US"
          },
          {
            "position": 3,
            "url": "https://www.idealhome.co.uk/house-manual/floorcare/mova-p50-pro-ultra-robot-vacuum-review?utm_source=chatgpt.com",
            "label": "I've spent years telling people that robot mops aren't worth the money - the MOVA P50 Pro Ultra is the first one to change my mind",
            "site": "Ideal Home",
            "description": "The review provides a detailed assessment of the MOVA P50 Pro Ultra Robot Vacuum, marking a pivotal shift in the author's long-standing skepticism toward robot mops. …"
          },
          "…"
        ],
        "images": [],
        "complete": true
      },
      "…"
    ]
  }
}

task.statusstring

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

response.textstring

La respuesta en texto plano.

response.entityDetailsarray

Un panel por tarjeta, hasta 20: name, category, query, status (ok o failed), markdown, sources, products, images y complete. Una tarjeta que falla trae error, y la respuesta termina igual.

response.followUpsarray

Una respuesta por cada seguimiento, en orden. Cada elemento trae el prompt enviado, selection (el botón y los valores) en un select, y los campos de la primera respuesta, como text, markdown, sources, searchQueries y model.

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

VALIDATION_ERRORHTTP 422

include.entityDetails se envió a un motor distinto de CHATGPT, junto con include.html o con un valor que no es booleano. details indica payload.include.entityDetails.

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

Los detalles de tarjeta son gratis. Una tarea de ChatGPT cuesta lo mismo con o sin include.entityDetails: 1 crédito por respuesta, incluida cada respuesta de seguimiento.