체인지로그새 기능

Product Lookup을 소개해요

Product Lookup
belif Moisturizing Eye Bomb과 경쟁 상품 2개를 비교한 Product Lookup 결과: ChatGPT, Google AI Overview, AI Mode, Copilot의 판매처 기록 수, 가격, 별점과 쇼핑 질문 답변 8개 중 각 상품이 나온 수

Product Lookup이 AI 쇼핑 엔진에 내 상품과 경쟁 상품을 묻고, 엔진마다 답변이 보여 준 판매처와 가격, 리뷰를 돌려줘요.

받는 결과

  • engines[]: 엔진마다 답변이 내 상품을 보여 줬는지(found)와, 보여 준 판매처 기록을 가격, 재고, 별점, 리뷰 수, 기록이 온 카탈로그와 함께 받습니다.
  • modelSees: ChatGPT 답변 모델이 판매처 기록에서 받은 상품명, 설명, 별점, 리뷰 수입니다. 모델이 내 상품을 어떤 정보로 읽는지 봅니다.
  • comparison[]: 내 상품과 경쟁 상품 최대 5개를 엔진마다 나란히 놓고 기록 수, 판매처 수, 리뷰가 가장 많은 기록, 가격 범위를 비교합니다.
  • prompts[]: 쇼핑 질문 최대 3개의 답변마다 조회한 상품 중 무엇을 보여 주고 이름을 말했는지 받습니다.
  • citedPages, summary.citedDomains: 답변이 인용한 페이지와, 엔진 전체에서 사이트별로 묶은 인용입니다.

동작 방식

상품 이름과 시장을 보냅니다. US에서는 ChatGPT에 “Buy …”와 “Find the best price for …”를 묻고, Google AI Overview, Google AI Mode, Bing Copilot에 상품 이름을 묻습니다. KR에서는 네이버 AI 탭과 Google AI Mode에 상품 이름을, ChatGPT에 “… 구매”와 “… 최저가”를 묻습니다. 경쟁 상품도 같은 질문을 받고, 쇼핑 질문은 쓴 그대로 엔진마다 한 번 묻습니다. 아래 예시의 상품 3개와 쇼핑 질문 2개는 약 2분 만에 끝났습니다.

답변의 상품 기록과 ChatGPT가 쇼핑 카드에 쓴 판매처와 가격을 읽고, 제목에 상품 이름이 담긴 것을 남깁니다. match.score는 기록이 상품 이름을 얼마나 담았는지 보여 주고, 세트, 미니, 리필은 variant로 표시됩니다. 조회는 매번 실시간 답변을 읽습니다. 같은 판매처 기록의 가격, 별점, 리뷰 수는 반복해도 그대로이고, 엔진이 보여 주는 판매처 구성은 답변마다 바뀌므로 반복 조회로 추세를 봅니다.

이렇게 활용하세요

  • 엔진마다 내 상품을 보여 주는지, 어느 판매처와 가격으로 보여 주는지 확인합니다.
  • 엔진마다 리뷰 수와 가격을 경쟁 상품과 나란히 봅니다. 아래 조회에서 Bing Copilot은 belif의 리뷰 2,942개를 Clinique 85,773개, CeraVe 117,193개와 함께 보여 줬습니다.
  • 쇼핑하는 사람이 묻는 카테고리 질문의 답변이 어느 상품을 앞세우는지 봅니다. 아래 조회에서 CeraVe는 답변 8개 중 5개, belif는 2개에 나왔습니다.
  • 상품 피드나 판매처 기록을 바꾸기 전과 후에 조회해 엔진이 보여 주는 내용을 비교합니다.

요청 보내기

API 키를 Authorization 헤더에 넣어 요청을 보냅니다.

curl -X POST https://api.querying.ai/v1/product-lookup \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "product": "belif Moisturizing Eye Bomb",
    "country": "US",
    "competitors": ["Clinique All About Eyes", "CeraVe Eye Repair Cream"],
    "prompts": [
      "best eye cream for puffiness",
      "best moisturizing eye cream"
    ],
    "idempotencyKey": "eye-bomb-us"
  }'

요청 필드

productstring필수
쇼핑하는 사람이 검색하는 상품 이름, 1~200자. 상품 페이지 URL이나 바코드를 넣으면 VALIDATION_ERROR입니다.
countrystring필수
US 또는 KR. 시장에 따라 묻는 엔진과 질문 문구가 정해집니다.
competitorsarray
경쟁 상품 이름 최대 5개. 각 상품에 내 상품과 같은 질문을 합니다.
promptsarray
쇼핑 질문 최대 3개. best eye cream for puffiness처럼 쓴 그대로 엔진마다 묻습니다.
enginesarray
질문할 엔진. US 기본은 CHATGPT, GOOGLE, AIMODE, BING_COPILOT, KR 기본은 NAVER_AI_TAB, CHATGPT, AIMODE입니다. GEMINI를 넣으면 Gemini에도 묻습니다.
idempotencyKeystring
조회 id가 됩니다. 같은 값으로 다시 보내면 같은 조회를 돌려주고 빠진 질문만 더합니다.
webhook.urlstring
서버의 HTTPS 주소입니다. 질문 태스크가 끝날 때마다 결과를 이 주소로 보냅니다.

응답

응답입니다. 길이를 줄여 보여 드립니다.

JSON
{
  "success": true,
  "lookup": {
    "id": "eye-bomb-us",
    "product": "belif Moisturizing Eye Bomb",
    "competitors": ["Clinique All About Eyes", "CeraVe Eye Repair Cream"],
    "prompts": [
      "best eye cream for puffiness",
      "best moisturizing eye cream"
    ],
    "country": "US",
    "engines": ["CHATGPT", "GOOGLE", "AIMODE", "BING_COPILOT"]
  },
  "summary": { "total": 23, "succeeded": 23, "failed": 0 },
  "credits": { "creditsToCharge": 40, "creditsCharged": 0 },
  "asks": [
    {
      "engine": "CHATGPT",
      "taskType": "CHATGPT",
      "role": "product",
      "prompt": "Buy belif Moisturizing Eye Bomb",
      "success": true,
      "task": {
        "id": "56be57f3-d316-4727-8bd3-ab065fed2ec1",
        "taskType": "CHATGPT",
        "status": "QUEUED",
        "priority": 1,
        "createdAt": "2026-10-20T09:22:43.422Z",
        "idempotencyKey": "eye-bomb-us:CHATGPT:buy"
      }
    },
    {
      "engine": "GOOGLE",
      "taskType": "GOOGLE",
      "role": "product",
      "query": "belif Moisturizing Eye Bomb",
      "success": true,
      "task": {
        "id": "0d6d6839-8705-44c1-ac3c-c5f56cb25d08",
        "taskType": "GOOGLE",
        "status": "QUEUED",
        "priority": 1,
        "createdAt": "2026-10-20T09:22:43.472Z",
        "idempotencyKey": "eye-bomb-us:GOOGLE:name"
      }
    },
    "…"
  ]
}
lookup.idstring
조회 id입니다. 보낸 idempotencyKey이거나 서버가 만든 값이고, GET /v1/product-lookup/{id}로 조회를 읽습니다.
summaryobject
질문 집계: total, succeeded, failed.
credits.creditsToChargenumber
모든 질문이 답하면 차감되는 크레딧입니다. 상품마다 10크레딧, 쇼핑 질문마다 5크레딧입니다.
asksarray
질문마다 하나씩 엔진, 물은 문장, task가 옵니다. 거절된 질문에는 코드가 담긴 error가 옵니다.

결과 받기

질문 하나가 태스크 하나라서 답변이 도착하는 대로 조회가 채워집니다. lookup.status가 COMPLETED가 될 때까지 GET /v1/product-lookup/{id}로 읽거나, webhook.url을 넣어 끝난 질문 태스크를 하나씩 받으세요. 조회는 질문이 끝난 뒤 24시간 동안 읽을 수 있습니다.

curl "https://api.querying.ai/v1/product-lookup/$LOOKUP_ID" \
  -H "Authorization: Bearer $QUERYING_API_KEY"

끝난 조회는 이런 형태입니다. 길이를 줄여 보여 드립니다.

JSON
{
  "success": true,
  "lookup": {
    "id": "eye-bomb-us",
    "product": "belif Moisturizing Eye Bomb",
    "competitors": ["Clinique All About Eyes", "CeraVe Eye Repair Cream"],
    "prompts": [
      "best eye cream for puffiness",
      "best moisturizing eye cream"
    ],
    "country": "US",
    "status": "COMPLETED",
    "createdAt": "2026-10-20T09:22:43.422Z",
    "completedAt": "2026-10-20T09:24:36.695Z",
    "credits": 40
  },
  "summary": {
    "foundIn": ["CHATGPT", "GOOGLE", "AIMODE", "BING_COPILOT"],
    "notFoundIn": [],
    "merchants": [
      {
        "merchant": "Ulta Beauty",
        "engines": ["CHATGPT", "BING_COPILOT"],
        "price": { "currency": "USD", "min": 48, "max": 48 }
      },
      {
        "merchant": "Amazon",
        "engines": ["CHATGPT"],
        "price": { "currency": "USD", "min": 43, "max": 43 }
      },
      "…"
    ],
    "priceRange": { "currency": "USD", "min": 35.82, "max": 48 },
    "citedDomains": [
      {
        "domain": "ulta.com",
        "engines": ["CHATGPT", "GOOGLE", "AIMODE", "BING_COPILOT"]
      },
      "…"
    ],
    "credits": 10
  },
  "engines": [
    {
      "engine": "CHATGPT",
      "status": "COMPLETED",
      "found": true,
      "via": [
        {
          "taskType": "CHATGPT",
          "prompt": "Buy belif Moisturizing Eye Bomb",
          "taskId": "56be57f3-d316-4727-8bd3-ab065fed2ec1",
          "status": "COMPLETED",
          "credits": 2
        },
        "…"
      ],
      "listings": [
        {
          "ask": 1,
          "position": 1,
          "title": "belif Moisturizing Eye Bomb Eye Cream",
          "merchant": "Ulta Beauty",
          "source": "merchant_feed",
          "price": { "value": 48, "currency": "USD", "raw": "$48.00" },
          "available": true,
          "modelSees": {
            "rating": 4.5,
            "reviewCount": 105,
            "brand": "belif"
          },
          "match": { "score": 1 }
        },
        {
          "ask": 2,
          "position": 1,
          "title": "Amazon",
          "merchant": "Amazon",
          "source": "chatgpt_widget",
          "price": { "value": 43, "currency": "USD", "raw": "$43.00" },
          "match": { "score": 1 }
        },
        "…"
      ],
      "citedPages": [
        {
          "ask": 1,
          "domain": "lgbeauty.com",
          "title": "Moisturizing Eye Bomb"
        },
        "…"
      ]
    },
    "…"
  ],
  "comparison": [
    {
      "product": "belif Moisturizing Eye Bomb",
      "role": "product",
      "engines": [
        {
          "engine": "BING_COPILOT",
          "status": "COMPLETED",
          "found": true,
          "listings": 6,
          "merchants": 5,
          "mostReviewed": {
            "reviewCount": 2942,
            "rating": 4.58,
            "merchant": "Comparor"
          },
          "priceRange": { "currency": "USD", "min": 35.82, "max": 48 },
          "prompts": { "answered": 2, "appeared": 1 }
        },
        "…"
      ]
    },
    {
      "product": "CeraVe Eye Repair Cream",
      "role": "competitor",
      "engines": [
        {
          "engine": "BING_COPILOT",
          "status": "COMPLETED",
          "found": true,
          "listings": 6,
          "merchants": 6,
          "mostReviewed": {
            "reviewCount": 117193,
            "rating": 4.35,
            "merchant": "Pasteur Pharmacy"
          },
          "priceRange": { "currency": "USD", "min": 15.95, "max": 38.95 },
          "prompts": { "answered": 2, "appeared": 0 }
        },
        "…"
      ]
    },
    "…"
  ],
  "prompts": [
    {
      "prompt": "best moisturizing eye cream",
      "engines": [
        {
          "engine": "GOOGLE",
          "status": "COMPLETED",
          "shown": ["CeraVe Eye Repair Cream", "Clinique All About Eyes"],
          "named": [
            "belif Moisturizing Eye Bomb",
            "CeraVe Eye Repair Cream",
            "Clinique All About Eyes"
          ]
        },
        {
          "engine": "BING_COPILOT",
          "status": "COMPLETED",
          "shown": ["belif Moisturizing Eye Bomb"],
          "named": ["belif Moisturizing Eye Bomb"]
        },
        "…"
      ]
    },
    "…"
  ]
}
lookup.statusstring
질문이 도는 동안 QUEUED, PROCESSING이고, 모든 질문이 끝나고 하나라도 답하면 COMPLETED, 모두 실패하면 FAILED입니다.
lookup.creditsnumber
지금까지 답한 질문에 차감된 크레딧입니다.
engines[].foundboolean
엔진의 답변이 상품을 보여 줬는지입니다. 판매처 기록이나 ChatGPT 쇼핑 카드가 하나라도 있으면 true입니다.
engines[].listingsarray
상품을 보여 준 판매처 기록마다 merchant, price, available, 별점과 리뷰 수, 기록이 온 카탈로그(source)가 붙고, ChatGPT는 답변 모델이 받은 정보(modelSees)도 붙습니다.
summary.merchantsarray
상품을 보여 준 판매처마다 그 판매처를 보여 준 엔진과 가격 범위입니다.
comparisonarray
내 상품과 경쟁 상품을 엔진마다 나란히 놓습니다. found, listings, merchants, mostReviewed, priceRange와 쇼핑 질문 답변에 나온 횟수가 붙습니다.
prompts[].enginesarray
쇼핑 질문과 엔진마다, 답변이 보여 준 조회 상품(shown)과 본문에서 이름을 말한 조회 상품(named)입니다.

오류

VALIDATION_ERRORHTTP 400
필드가 빠졌거나 허용 범위를 벗어났습니다. details에 해당 필드가 나옵니다.
REGION_UNSUPPORTEDHTTP 422
country가 US, KR 밖의 시장입니다.
RESOURCE_ALREADY_EXISTSHTTP 409
이 idempotencyKey가 이미 다른 상품, 경쟁 상품, 쇼핑 질문이나 국가의 조회에 쓰였습니다. 새 키로 보내세요.
INSUFFICIENT_CREDITSHTTP 402
잔액이 태스크 가격보다 적습니다. 크레딧을 충전하거나 플랜을 올린 뒤 다시 보내세요.
PLAN_CONCURRENCY_LIMITHTTP 429
플랜의 동시 태스크가 가득 찼습니다. 들어갈 수 있는 질문만 들어가고 나머지는 이 코드로 asks[]에 남으며, Retry-After초 뒤 같은 요청을 다시 보내면 나머지를 더합니다. 하나도 들어가지 못하면 요청 전체가 429입니다.

요금

상품은 내 상품과 경쟁 상품 모두 하나에 10크레딧, 쇼핑 질문은 하나에 5크레딧이고, 어느 엔진에 묻든 같습니다. 가격은 그 상품의 질문에 나눠 매기고, 답한 질문만 차감합니다. 위 조회는 상품 3개와 쇼핑 질문 2개로 40크레딧입니다.

다른 업데이트

새 소식을 받아보세요

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

RSS 구독