Os cartões do ChatGPT chegam com o painel de detalhes

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.

{
  "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 status QUEUED. 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.

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

Erros

VALIDATION_ERRORHTTP 422

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.