API de ChatGPT: respuestas, fuentes y consultas de búsqueda

CHATGPT pregunta a ChatGPT con la búsqueda web activada y devuelve la respuesta, todas las fuentes que encontró, las búsquedas que ejecutó y las tarjetas de productos y lugares que dibujó.


taskType	`CHATGPT`
Lee	`prompt` (recurre a `query`)
Créditos	1 por respuesta
País	Opcional, por defecto `US`. `CN` y `HK` se preguntan desde una salida en Singapur con una ubicación de dispositivo local.
Ubicación	Acepta `payload.location`. Consulta Regiones y ubicación.

Solicitud

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": "best CRM for a small team", "country": "US" } }'

Respuesta

Campo	Tipo	Descripción
`text`	string	La respuesta como texto plano.
`markdown`	string	La respuesta en Markdown, con las fotos en el lugar de su tarjeta. Activado por defecto.
`model`	string	El modelo con el que respondió ChatGPT.
`sources`	array	Todas las fuentes: `position`, `url`, `label`, `footnote`, `datePublished`, `searchQueries`, `cited`, `citedText`.
`searchQueries`	string[]	Las búsquedas web que ejecutó ChatGPT. Activado por defecto.
`shoppingCards`, `inlineProducts`	array	Tarjetas de producto y nombres de producto enlazados en la respuesta. Activado por defecto (`include.shopping`).
`ads`	array	Elementos patrocinados en la respuesta. Activado por defecto (`include.ads`).
`entities`	array	Lugares y productos nombrados en las tarjetas, cada uno con su `type`, como `local_business` o `product`, y su `name`.
`entityDetails`	array	El panel de detalle de cada tarjeta. Solo con `include.entityDetails`. Consulta Detalles de tarjetas.
`map`	array	Lugares mostrados en tarjetas: dirección, coordenadas, teléfono, valoración y el emoji `icon` con el que ChatGPT los marca. `provider` es el feed del que procede el registro (`serp` y `bright-feed` para Google Maps, `yelp-feed` para Yelp, `tripadvisor-feed` para Tripadvisor); `placeId` y `providerUrl` son el ID y la página del lugar en ese feed. `resolvedBy: "address"` marca un lugar que ChatGPT encontró por la dirección que escribió el modelo. `localName` es el otro nombre del registro, como el nombre coreano de una tienda en Corea, y `closed` es `permanently` o `temporarily`.
`citationPills`	array	Las fuentes detrás de cada chip de cita en línea.
`layout`	object	La disposición en tarjetas, cuando ChatGPT dibuja la respuesta como tarjetas. Ver abajo.
`forms`	array	Formularios de seguimiento de la respuesta, cuando los hay. Consulta Conversaciones.
`conversation`	object	`id`, `turn` y `expiresAt` de la conversación a la que pertenece la respuesta.
`html`	object	La pantalla que mostró ChatGPT. Solo con `include.html`.
`rawResponse`	array	Eventos de stream parseados. Solo con `include.rawResponse`.

Por ejemplo, una respuesta recortada:

{
  "text": "For a small team, HubSpot CRM and Pipedrive are the usual picks ...",
  "markdown": "For a small team, **HubSpot CRM** and **Pipedrive** are the usual picks ...",
  "model": "gpt-5-3",
  "sources": [
    {
      "position": 1,
      "url": "https://www.example.com/best-crm-small-business",
      "label": "The best CRM software for small businesses",
      "searchQueries": ["best CRM for small teams"],
      "cited": true,
      "citedText": ["HubSpot CRM and Pipedrive are the usual picks"]
    }
  ],
  "searchQueries": ["best CRM for small teams"],
  "conversation": { "id": "8f6c1d2e-...", "turn": 1, "expiresAt": "2026-10-19T12:00:00.000Z" }
}

Cada fuente incluye searchQueries (las búsquedas cuyos resultados la incluyeron), cited (si la respuesta la cita en el texto) y citedText (el texto de la respuesta que respalda cada cita). Las fuentes que no devolvió ninguna búsqueda, como los productos, no llevan searchQueries.

Disposición en tarjetas

layout aparece cuando ChatGPT dibuja la respuesta como tarjetas. Sus nodes siguen el orden en que ChatGPT los muestra:

Nodo	Contiene
`row`, `box`	Grupos de tarjetas.
`title`, `text`, `badge`	El texto de la tarjeta.
`image`	La foto: `images[].url`, `thumbnailUrl` y `pageUrl`.
`markdown`	El resto de la respuesta.
`map`	En `places`, la `position` de cada lugar que muestra.
`form`	Un formulario que te pide elegir una pregunta de seguimiento. Sus nodos `choice` contienen las opciones y la seleccionada al inicio; su nodo `button` contiene la pregunta que ChatGPT enviaría a continuación (`prompt`). Los formularios quedan fuera de `text` y `markdown`.

Flags include

CHATGPT respeta todos los flags de respuesta. Todos están activados por defecto salvo rawResponse y html; envía false para desactivar uno.

Flag	Por defecto	Efecto
`markdown`	`true`	Añade `markdown`.
`searchQueries`	`true`	Añade `searchQueries`.
`shopping`	`true`	Añade las tarjetas de producto.
`ads`	`true`	Añade `ads`.
`rawResponse`	`false`	Añade `rawResponse`. Consulta Respuestas en Markdown y en bruto.
`html`	`false`	Añade `html`, 0,25 créditos cuando se guarda la página. Se rechaza con `422 EVIDENCE_UNSUPPORTED` junto con `location`, `CN`, `HK` o `continueFrom`. Consulta Páginas HTML.
`analysis`	`false`	Añade `analysis`, 1 crédito. Consulta Análisis de la respuesta.
`citationAnalysis`	`false`	Ejecuta un Citation Analysis sobre la respuesta.
`entityDetails`	`false`	Añade `entityDetails` sin créditos adicionales. Consulta Detalles de tarjetas.

Detalles de tarjetas

Con include.entityDetails, cada tarjeta de la respuesta (un producto, lugar, app o marca) llega con el panel de detalle que ChatGPT abre cuando el lector hace clic en ella: descripción, especificaciones, reseñas y las páginas que las respaldan. Los paneles citan sus propias páginas, así que muestran fuentes que el texto de la respuesta no incluye.

Campo	Descripción
`name`, `category`, `query`	La tarjeta tal como la muestra la respuesta, su tipo (`product`, `local_business`, `software`, `organization`) y el nombre con el que ChatGPT la buscó.
`status`	`ok`, o `failed` con un `error`.
`markdown`	El panel en Markdown, con los chips de cita escritos como en la respuesta.
`sources`	Cada página citada una vez, en el orden de su primera cita: `position`, `url`, `label`, `site`, `description`.
`products`	La ficha de compra con la que abre el panel de un producto: `title`, `price`, `merchant`, `rating`, `num_reviews`, `url` y `offers`, con la forma de `shoppingCards[].products`. Solo cuando el panel la muestra.
`images`	Las fotos del panel.
`complete`	`false` cuando ChatGPT dejó de escribir el panel antes de terminarlo. Incluye el texto y las fuentes hasta ese punto.

error es ENTITY_DETAIL_FAILED si falla la solicitud del panel, ENTITY_DETAIL_EMPTY si el panel no contiene texto y ENTITY_DETAIL_UNAVAILABLE si faltan los datos de la conversación o las credenciales del turno necesarios para abrirlo. Los detalles también funcionan con payload.location, CN, HK, respuestas de la vía alternativa e include.html. Un panel que ChatGPT ya escribió antes llega en un segundo aproximadamente; uno que escribe al pedirlo tarda de 10 a 30 segundos, con hasta 4 paneles a la vez. Se abren hasta 20 tarjetas por respuesta. Los paneles no suman créditos, y cada respuesta de seguimiento recibe sus propios paneles.

"entityDetails": [
  {
    "name": "Brooks Adrenaline GTS 25",
    "category": "product",
    "query": "Brooks Adrenaline GTS 25",
    "status": "ok",
    "markdown": "## Brooks Adrenaline GTS 25\n\nThe **Brooks Adrenaline GTS 25** is a **stability road running shoe** ... ([Brooks Running](https://www.brooksrunning.com/...))\n\n### Key specifications\n\n| Feature | Details |\n| --- | --- |\n| Heel-to-toe drop | 10 mm |\n...",
    "sources": [
      { "position": 1, "url": "https://www.brooksrunning.com/...", "label": "Men's Adrenaline GTS 25 Running Shoes | Brooks Running", "site": "Brooks Running" },
      { "position": 2, "url": "https://www.rei.com/product/249691/...", "label": "Brooks Adrenaline GTS 25 Road-Running Shoes - Men's | REI Co-op", "site": "REI" }
    ],
    "images": ["https://images.openai.com/..."],
    "complete": true
  }
]

Preguntas de seguimiento

payload.followUps hace hasta 4 preguntas más en la misma conversación después de la primera respuesta, en orden. Cada elemento es uno de estos:

{ "prompt": "..." }: una pregunta propia.
{ "select": { "button": 0, "choices": { "budget": "Under $100" } } }: pulsa el botón de un formulario de seguimiento de la respuesta anterior.

button cuenta los botones de la respuesta desde 0 y por defecto es el primero. choices elige opciones por el name de cada nodo choice, o como un array en el orden del formulario; cada elección es el value o el label de una opción, o su posición desde 0. Lo que no elijas conserva la opción que ChatGPT dejó seleccionada, así que { "select": {} } envía el prompt propio del botón.

{
  "taskType": "CHATGPT",
  "payload": {
    "prompt": "best CRM for a small team",
    "country": "US",
    "followUps": [{ "prompt": "Which of these has the best free plan?" }]
  }
}

Los campos de nivel superior siguen siendo la primera respuesta. followUps en la respuesta lista cada respuesta adicional con la pregunta que se envió (prompt), lo que pulsó un select (selection: el label del botón y el valor de cada elección) y los mismos campos que la primera respuesta. Cuando no se puede pulsar un select, las preguntas de seguimiento restantes no se hacen y followUpsStopped indica el index de esa pregunta, un code y un message:

Código	Significado
`NO_FOLLOW_UP_FORM`	La respuesta anterior no mostró ningún formulario.
`BUTTON_NOT_FOUND`	No hay ningún botón en ese índice.
`CHOICE_NOT_FOUND`	No hay ninguna elección con ese nombre.
`OPTION_NOT_FOUND`	Ninguna opción coincide con la elección.
`PROMPT_UNAVAILABLE`	El botón no tenía ninguna pregunta que enviar.

La tarea se completa igualmente con las respuestas obtenidas. Cada respuesta cuesta 1 crédito: la tarea reserva créditos para cada pregunta de seguimiento y solo cobra las respuestas que devuelve. include.analysis, include.citationAnalysis e include.html se aplican a la primera respuesta. Los demás motores rechazan followUps con 400 VALIDATION_ERROR.

Continuar una conversación más tarde

Para leer una respuesta antes de elegir la siguiente pregunta, envía una nueva tarea CHATGPT con payload.continueFrom igual al id de una tarea completada y, además, un prompt o un select que pulse un formulario de la última respuesta de esa tarea (las mismas reglas que en followUps).

{
  "taskType": "CHATGPT",
  "payload": {
    "continueFrom": "8f6c1d2e-...",
    "select": { "button": 0 }
  }
}

Una respuesta que muestra un formulario incluye forms: los buttons de cada formulario, cuyo orden es select.button, y sus choices con su name, la opción seleccionada al principio y las options.
conversation.id es la tarea que abrió la conversación, turn cuenta sus respuestas hasta ahora y expiresAt es el último momento para continuarla, 3 horas después de su primera respuesta.
Una continuación pregunta bajo la última respuesta de la tarea que indiques, así que indicar la misma tarea dos veces ramifica la conversación.
Conserva el country y la location originales. Omítelos o envía los mismos valores.
Una tarea de otra cuenta o de otro motor, una tarea que no se ha completado o un select no válido se rechazan con 400 VALIDATION_ERROR. Una conversación caducada se rechaza con 400 CONVERSATION_EXPIRED. Ninguno de los dos casos se cobra.
Una continuación cuesta lo mismo que cualquier tarea de ChatGPT.

Primeros pasos

Conceptos clave

Motores de respuesta

Búsqueda y datos web

Opciones de solicitud

Investigación

Monitorización GEO

Cuenta y datos

API de ChatGPT: respuestas, fuentes y consultas de búsqueda

Solicitud

Respuesta

Disposición en tarjetas

Flags include

Detalles de tarjetas

Preguntas de seguimiento

Continuar una conversación más tarde

Relacionado

​Solicitud

​Respuesta

​Disposición en tarjetas

​Flags include

​Detalles de tarjetas

​Preguntas de seguimiento

​Continuar una conversación más tarde

​Relacionado

Solicitud

Respuesta

Disposición en tarjetas

Flags include

Detalles de tarjetas

Preguntas de seguimiento

Continuar una conversación más tarde

Relacionado