Os cartões do ChatGPT chegam com o painel de detalhes
ChatGPT
Ative include.entityDetails numa tarefa do ChatGPT e receba sem custo extra o painel que o ChatGPT abre para cada cartão de produto, lugar ou marca da resposta, com texto, fontes e imagens.
O que você recebe
payload.include.entityDetails: true em tarefas CHATGPT.
entityDetails na resposta e em cada resposta de followUps: uma entrada por cartão que a resposta cita, até 20.
Cada entrada tem name, category (product, local_business, software, organization, brand e outras), query, status, markdown, sources, products, images e complete.
sources lista os sites que o painel cita, com position, url, label, site e description.
Como funciona
Quando um usuário clica num cartão de produto, lugar ou marca numa resposta do ChatGPT, o ChatGPT abre um painel e escreve um perfil curto, citando os sites que leu. Quando a resposta termina, esse mesmo painel é pedido para cada cartão, na mesma conversa, quatro cartões por vez. A etapa de detalhes soma cerca de 10 segundos a cada resposta.
markdown é o painel como o ChatGPT o escreveu, com títulos, listas e links das fontes. complete: false indica que o ChatGPT parou de escrever antes do fim do painel; o texto e as fontes escritos até ali são mantidos.
Cada cartão é processado separadamente. Um cartão que falha traz status: "failed" e um error (ENTITY_DETAIL_FAILED ou ENTITY_DETAIL_EMPTY), e a resposta e os outros cartões terminam normalmente. Em tarefas com location, CN ou HK, os cartões voltam com ENTITY_DETAIL_UNAVAILABLE.
include.entityDetails funciona em CHATGPT e é enviado sem include.html. Enviado a outro mecanismo ou junto com include.html, a API devolve 422 VALIDATION_ERROR antes de reservar créditos.
Onde ajuda
Leia como o ChatGPT descreve seu produto quando um comprador clica no cartão e confira as especificações, preços e afirmações que ele repete.
Veja quais sites o ChatGPT cita para o seu produto e para cada concorrente, e planeje avaliações e anúncios em torno deles.
Faça a mesma pergunta em vários países e compare como o painel de cada mercado apresenta a mesma marca.
Envie a requisição
Envie a requisição com a sua chave de API no cabeçalho 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 da requisição
taskTypestringObrigatório
O motor que executa a tarefa, como CHATGPT ou GOOGLE.
payload.promptstringObrigatório
A pergunta, escrita como o usuário digita no chat. Até 100.000 caracteres.
payload.countrystring
Código de país de duas letras do mercado de onde a pergunta parte, como US, KR ou JP. Padrão US.
payload.include.entityDetailsboolean
Com true, chega também entityDetails: o painel de detalhes que o ChatGPT abre para cada cartão da resposta. Em CHATGPT, sem include.html. Desativado por padrão, sem créditos extras.
payload.followUpsarray
Até 4 turnos a mais na mesma conversa do ChatGPT depois da primeira resposta. Cada item é {"prompt": "…"} para fazer uma pergunta ou {"select": {…}} para apertar um botão do formulário da resposta anterior. Para CHATGPT.
webhook.urlstring
Um endereço HTTPS do seu servidor. A tarefa concluída é enviada para lá assim que termina.
Resposta
Uma tarefa concluída chega assim, resumida para facilitar a leitura.
JSON
{
"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 e, no fim, COMPLETED com a resposta ou FAILED com error.
response.textstring
A resposta em texto puro.
response.entityDetailsarray
Um painel por cartão, até 20: name, category, query, status (ok ou failed), markdown, sources, products, images e complete. Um cartão que falha traz error, e a resposta termina normalmente.
response.followUpsarray
Uma resposta por pergunta de acompanhamento, em ordem. Cada item traz o prompt enviado, selection (o botão e os valores) num select, e os campos da primeira resposta, como text, markdown, sources, searchQueries e model.
Receba o resultado
A requisição devolve a tarefa na hora, com statusQUEUED. Consulte GET /v1/async/task/{id} até status virar COMPLETED ou FAILED, ou adicione webhook.url e a tarefa concluída chega ao seu servidor com os mesmos task, credits e response. Os resultados ficam disponíveis por 24 horas após o fim da tarefa.
include.entityDetails foi enviado a um mecanismo diferente de CHATGPT, junto com include.html ou com um valor que não é booleano. details indica payload.include.entityDetails.
MISSING_API_KEYHTTP 401
Falta o cabeçalho Authorization, ou a chave é desconhecida, expirou ou foi revogada.
INSUFFICIENT_CREDITSHTTP 402
O saldo é menor que o preço da tarefa. Adicione créditos ou mude de plano e envie de novo.
Preço
Os detalhes dos cartões são gratuitos. Uma tarefa do ChatGPT custa o mesmo com ou sem include.entityDetails: 1 crédito por resposta, incluindo cada resposta de acompanhamento.
Acompanhe o modelo que responde, cada campo da resposta e as mudanças de cada dia no ChatGPT, Gemini, Google AI Overviews e Google AI Mode, em uma página pública e uma API gratuita.
Pergunte ao Bing AI Mode, também chamado de Bing Copilot Search, em 11 países e receba a resposta com as páginas que ele leu, os lugares que cita e os produtos patrocinados exibidos acima.