체인지로그새 기능

ChatGPT 카드의 상세 창까지 받아요

ChatGPT
로봇청소기 질문에 답한 ChatGPT 화면에서 답변 옆에 Roborock Saros 20 상세 창이 열려 있고, 그 창이 entityDetails로 표시된 모습

ChatGPT 태스크에 include.entityDetails를 켜면, 답변에 나온 상품, 장소, 브랜드 카드마다 ChatGPT가 여는 상세 창의 본문, 출처, 이미지를 추가 비용 없이 받아요.

받는 결과

  • CHATGPT 태스크에서 payload.include.entityDetails: true를 씁니다.
  • 답변과 followUps의 각 답변에 entityDetails가 붙습니다. 답변에 나온 카드마다 한 항목이며, 20개까지입니다.
  • 항목에는 name, category(product, local_business, software, organization, brand 등), query, status, markdown, sources, products, images, complete가 담깁니다.
  • sources는 상세 창이 인용한 사이트 목록이며, position, url, label, site, description을 담습니다.

동작 방식

ChatGPT 답변에서 상품, 장소, 브랜드 카드를 누르면 ChatGPT가 상세 창을 열고, 읽은 사이트를 인용하며 그 대상을 짧게 소개합니다. 답변이 끝나면 같은 대화에서 답변의 모든 카드에 이 상세 창을 요청하며, 한 번에 카드 4개씩 묻습니다. 상세 단계는 답변 하나에 약 10초를 더합니다.

markdown은 ChatGPT가 쓴 상세 창 그대로이며 제목, 목록, 출처 링크가 들어 있습니다. complete: false는 ChatGPT가 상세 창을 끝까지 쓰기 전에 멈췄다는 뜻이고, 그때까지 쓴 본문과 출처는 그대로 담깁니다.

카드는 하나씩 따로 처리됩니다. 실패한 카드는 status: "failed"와 error(ENTITY_DETAIL_FAILED 또는 ENTITY_DETAIL_EMPTY)를 담고, 답변과 다른 카드는 평소처럼 완료됩니다. location, CN, HK를 쓴 태스크의 카드는 ENTITY_DETAIL_UNAVAILABLE로 돌아옵니다.

include.entityDetails는 CHATGPT에서 include.html 없이 씁니다. 다른 엔진에 보내거나 include.html과 함께 보내면 크레딧을 잡기 전에 422 VALIDATION_ERROR를 돌려줍니다.

이렇게 활용하세요

  • 쇼핑하는 사용자가 내 상품 카드를 눌렀을 때 ChatGPT가 어떻게 소개하는지 읽고, 그대로 옮기는 사양, 가격, 주장을 점검합니다.
  • 내 상품과 경쟁 상품마다 ChatGPT가 인용하는 사이트를 확인하고, 리뷰와 입점 계획을 그 사이트에 맞춥니다.
  • 같은 질문을 여러 국가에서 물어, 시장마다 같은 브랜드를 상세 창에서 어떻게 소개하는지 비교합니다.

요청 보내기

API 키를 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 }
    }
  }'

요청 필드

taskTypestring필수
실행할 엔진입니다. CHATGPT, GOOGLE 같은 값을 넣습니다.
payload.promptstring필수
사용자가 채팅에 입력하듯 쓴 질문입니다. 최대 100,000자.
payload.countrystring
질문할 시장의 두 글자 국가 코드입니다. US, KR, JP 등. 기본값 US.
payload.include.entityDetailsboolean
true면 답변의 카드마다 ChatGPT가 여는 상세 창인 entityDetails를 받습니다. CHATGPT에서 include.html 없이 씁니다. 기본으로 꺼져 있고 추가 크레딧이 없습니다.
payload.followUpsarray
첫 답변 뒤 같은 ChatGPT 대화에서 이어 갈 차례, 최대 4개. 항목마다 질문을 보내는 {"prompt": "…"}이거나, 앞 답변에 있는 양식의 버튼을 누르는 {"select": {…}}입니다. CHATGPT에서 씁니다.
webhook.urlstring
서버의 HTTPS 주소입니다. 태스크가 끝나는 즉시 결과를 이 주소로 보냅니다.

응답

완료된 태스크는 이런 형태입니다. 길이를 줄여 보여 드립니다.

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을 거쳐 답변과 함께 COMPLETED로, 또는 error와 함께 FAILED로 끝납니다.
response.textstring
답변 평문입니다.
response.entityDetailsarray
카드마다 상세 창 하나씩, 20개까지 담깁니다. name, category, query, status(ok 또는 failed), markdown, sources, products, images, complete가 있습니다. 실패한 카드에는 error가 붙고, 답변은 그대로 완료됩니다.
response.followUpsarray
이어 간 차례마다 답변 하나씩, 보낸 순서대로 담깁니다. 항목마다 보낸 prompt, select였다면 누른 버튼과 고른 값인 selection, 그리고 text, markdown, sources, searchQueries, model 같은 첫 답변의 필드가 있습니다.

결과 받기

요청하면 status가 QUEUED인 태스크가 바로 돌아옵니다. status가 COMPLETED나 FAILED가 될 때까지 GET /v1/async/task/{id}로 조회하거나, webhook.url을 넣어 같은 task, credits, response를 서버로 받으세요. 결과는 태스크가 끝난 뒤 24시간 동안 조회됩니다.

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

오류

VALIDATION_ERRORHTTP 422
include.entityDetails를 CHATGPT가 아닌 엔진에 보냈거나, include.html과 함께 보냈거나, boolean이 아닌 값으로 보냈습니다. details에 payload.include.entityDetails가 나옵니다.
MISSING_API_KEYHTTP 401
Authorization 헤더가 빠졌거나, 키가 잘못됐거나 만료 또는 폐기됐습니다.
INSUFFICIENT_CREDITSHTTP 402
잔액이 태스크 가격보다 적습니다. 크레딧을 충전하거나 플랜을 올린 뒤 다시 보내세요.

요금

카드 상세는 무료입니다. ChatGPT 태스크는 include.entityDetails를 켜도 가격이 같으며, 후속 질문 답변을 포함해 답변 하나에 1크레딧입니다.

다른 업데이트

새 소식을 받아보세요

제품 업데이트를 이메일로 보내드립니다.

RSS 구독