Product Lookup: AI 쇼핑 답변 속 상품 노출 조회 API
상품 이름을 보내면 ChatGPT, Google AI 개요, AI Mode, Copilot, 네이버 AI 탭 중 어느 엔진이 그 상품을 보여 주는지 확인합니다. 엔진별 판매처와 가격, 답변이 인용한 페이지, 경쟁 상품과의 비교를 API로 받습니다.
Copilot어느 엔진이 상품을 보여 주는지
상품 이름과 국가(US 또는 KR)를 보냅니다. 엔진마다 found가 답변이 그 상품을 보여 줬는지 알려 주고, otherListings에는 함께 보여 준 다른 상품이 담깁니다. summary.foundIn과 summary.notFoundIn이 엔진을 두 목록으로 나눕니다.
판매처, 가격, 리뷰
답변이 보여 준 상품 기록마다 판매처, 가격, 출처 카탈로그가 붙고, 엔진이 제공하면 재고, 평점, 리뷰 수, 카탈로그 ID도 붙습니다. ChatGPT의 modelSees에는 답변 모델이 받은 상품 정보가, chatgpt_widget 기록에는 ChatGPT가 위젯 카드에 쓴 판매처와 가격이 담깁니다.
답변이 인용한 페이지
citedPages는 답변마다 인용한 페이지입니다. summary.citedDomains는 이를 사이트별로 묶어 인용한 엔진을 붙이고, summary.merchants는 판매처마다 그 판매처를 보여 준 엔진과 가격 범위를 담습니다.
경쟁 상품과 나란히 비교
경쟁 상품을 최대 5개까지 넣습니다. 경쟁 상품도 내 상품과 같은 질문을 받고, comparison[]이 모든 상품을 엔진별로 나란히 놓습니다.
- found: 엔진마다 각 상품을 보여 줬는지입니다.
- listings, merchants: 상품마다 받은 기록 수와 판매처 수입니다.
- mostReviewed, priceRange: 리뷰가 가장 많은 기록과 엔진이 보여 준 가격 범위입니다.
- prompts: 엔진이 답한 쇼핑 질문 수와 그중 상품을 보여 주거나 이름을 말한 답변 수입니다.
쇼핑 질문에 나오는 상품
"best eye cream for puffiness" 같은 쇼핑 질문을 최대 3개까지 넣습니다. 엔진마다 질문을 쓴 그대로 묻고, prompts[]가 답변이 기록으로 보여 준 상품(shown)과 본문에서 이름을 말한 상품(named)을 알려 줍니다.
시장별 엔진과 질문
시장마다 그 시장에서 상품 기록을 보여 주는 엔진에 묻습니다. engines로 엔진을 직접 고릅니다.
- US: ChatGPT에는 "Buy {상품}"과 "Find the best price for {상품}"을, Google AI 개요, AI Mode, Copilot에는 상품 이름을 묻습니다.
- KR: 네이버 AI 탭과 AI Mode에는 상품 이름을, ChatGPT에는 "{상품} 구매"와 "{상품} 최저가"를 묻습니다.
- Gemini는 engines에 넣으면 함께 묻습니다. KR에서는 Google AI 개요와 Copilot도 engines에 넣어 묻습니다.
POST /v1/product-lookup으로 제출
상품과 경쟁 상품 최대 5개, 쇼핑 질문 최대 3개를 보냅니다. 아래 조회는 엔진 4개에 상품 3개와 질문 2개를 물어 질문 23건, 40크레딧입니다. idempotencyKey가 조회 ID가 됩니다.
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"
}'질문 하나가 태스크 하나
응답은 질문마다 태스크를 돌려주고, credits.creditsToCharge가 그 가격을 더합니다. 질문은 일반 태스크처럼 실행되고 과금되며 웹훅을 보냅니다. 같은 ID로 다시 보내면 기존 질문을 돌려주고 빠진 질문만 넣습니다.
{
"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-…",
"taskType": "CHATGPT",
"status": "QUEUED",
"priority": 1,
"createdAt": "2026-10-20T09:22:43.422Z",
"idempotencyKey": "eye-bomb-us:CHATGPT:buy"
}
},
"…"
]
}GET /v1/product-lookup/:id로 읽기
lookup.status가 COMPLETED가 될 때까지 조회 ID로 폴링하거나, 질문의 웹훅이 올 때마다 읽습니다. 결과는 질문이 끝나고 24시간 안에 읽어 저장하세요.
curl https://api.querying.ai/v1/product-lookup/eye-bomb-us \
-H "Authorization: Bearer $QUERYING_API_KEY"비용
상품 하나는 10크레딧, 쇼핑 질문 하나는 5크레딧이고, 어느 엔진에 물어도 같습니다. 내 상품과 경쟁 상품을 각각 상품 하나로 세므로 위 조회는 40크레딧입니다. 상품 가격은 그 상품의 질문에 나눠 붙고, 실패한 질문의 크레딧은 잔액으로 돌아오며, 다시 보낸 요청은 새로 넣은 질문만 과금합니다.
요금제 확인 →| 플랜 | 상품 1,000개 |
|---|---|
| Basic | 약 35,000원 |
| Max | 약 14,000원 |
월 포함 크레딧을 모두 사용했을 때의 환산 단가입니다. 원화는 $1 ≈ 1,400원 기준입니다.
상품 50개로 측정한 결과
2026-10-20 운영 API로 미국 상품 25개와 한국 상품 25개를 조회했습니다.
- US: Copilot은 25개 모두, Google AI 개요와 AI Mode는 23개를 보여 줬습니다.
- KR: 네이버 AI 탭은 25개 모두, AI Mode는 13개를 보여 줬습니다.
- ChatGPT는 두 질문과 위젯 카드를 합쳐 미국 24회, 한국 20회 실행에서 모두 상품을 보여 줬습니다.
- 반복 실행에서 같은 판매처 기록의 가격, 평점, 리뷰 수는 값 316개 중 307개가 같았습니다. 어느 기록이 나오는지는 실행마다 바뀌므로 추세는 여러 번의 조회로 읽습니다.
