Commerce Product API (COMMERCE_PRODUCT)

​

요청

curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "taskType": "COMMERCE_PRODUCT", "payload": { "url": "https://www.amazon.com/dp/B00TTD9BRC" } }'

​

입력

• url: 필수. 아래 쇼핑몰의 상품 페이지이며 2,048자 이하입니다. Commerce Search가 이 쇼핑몰들에서 돌려준 상품 url을 그대로 넣을 수 있습니다. 단, Yahoo! Shopping의 LOHACO 페이지(lohaco.yahoo.co.jp)는 받지 않습니다. 추적 코드처럼 결과에 영향이 없는 파라미터는 읽기 전에 뺍니다.
• country: 선택. 기본값은 쇼핑몰의 국가입니다. 다른 국가는 422 REGION_UNSUPPORTED로 거절합니다.

​

응답 예시

{
  "site": "amazon",
  "country": "US",
  "url": "https://www.amazon.com/dp/B00TTD9BRC",
  "productId": "B00TTD9BRC",
  "title": "CeraVe Moisturizing Cream, Face & Body Moisturizer for Dry Skin, 19oz",
  "brand": "CeraVe",
  "price": 16.77,
  "listPrice": 18.96,
  "currency": "USD",
  "inStock": true,
  "seller": "Amazon.com",
  "rating": 4.7,
  "reviewCount": 149149,
  "images": ["https://m.media-amazon.com/images/I/61EidjXUBrL._SL1000_.jpg"],
  "description": "[ HYALURONIC ACID MOISTURIZER ] With hyaluronic acid, ceramides and MVE technology for 24 hour hydration.",
  "descriptionImages": ["https://m.media-amazon.com/images/S/aplus-media-library-service-media/8c56d081-e316-4b57-9731-fcf4eda0821f.__CR0,0,1464,600_PT0_SX1464_V1___.jpg"],
  "specs": [
    { "name": "Item Form", "value": "Cream" },
    { "name": "Skin Type", "value": "All, Dry, Sensitive" }
  ],
  "options": [{ "name": "Size", "values": ["8 Ounce", "16 Ounce (Pack of 1)", "19 Ounce (Pack of 1)"] }],
  "categories": ["Beauty & Personal Care", "Skin Care", "Face", "Creams & Moisturizers", "Face Moisturizers"]
}

​

결과 필드

• site, country, url, productId는 읽은 페이지를 나타냅니다. url은 실제로 읽은 페이지입니다. productId는 쇼핑몰 자체 상품 ID이며(Amazon은 ASIN, Rakuten은 shop:item) Commerce Search가 돌려주는 ID와 같습니다. 단, Nykaa에서 색상이나 용량 옵션이 있는 상품은 Commerce Search가 옵션 하나의 ID를, 이 읽기는 상품 페이지의 ID를 돌려줍니다.
• title은 항상 있습니다. 나머지 필드는 페이지에 있을 때 담으며, 필드별로 값을 돌려주는 쇼핑몰은 아래 표에 있습니다.
• price는 페이지가 처음 보여 주는 상품을 쿠폰과 배송비 전에 사는 가격이고, 통화는 currency(ISO 4217)입니다. listPrice는 페이지에 취소선으로 표시된 정가이며 price보다 높을 때 담습니다. inStock은 그 상품의 재고 여부, seller는 판매자입니다.
• rating은 5점 만점이며 소수점 둘째 자리까지입니다. reviewCount는 리뷰 수입니다.
• images는 상품 사진 목록의 사진 URL을 페이지 순서대로 최대 30개 담습니다. 11번가와 롯데온은 대표 사진 1장만, Sephora는 2장까지 주고, Rakuten과 Yahoo! Shopping은 판매자가 사진 목록에 올린 배너나 안내 이미지도 함께 옵니다. description은 문단마다 한 줄인 일반 텍스트이며 최대 10,000자입니다. 이미지 안에만 있는 글자는 담지 않습니다.
• descriptionImages는 판매자 상세페이지나 Amazon A+ 콘텐츠처럼 상품 설명 영역에 있는 이미지 URL을 페이지 순서대로 최대 300개 담습니다. 판매자가 설명에 넣은 배너와 안내 이미지도 함께 오고, 이미지 안의 글자는 읽지 않습니다.
• specs는 상품 상세 정보의 { name, value } 쌍을 최대 100개 담습니다. options는 사이즈, 색상 같은 선택지를 최대 20개 담고, 선택지마다 values는 최대 100개입니다. 다른 필드는 페이지가 처음 여는 선택지를 기준으로 합니다. categories는 넓은 카테고리부터 좁은 카테고리 순이며 최대 10단계입니다. gtin은 페이지에 적힌 UPC, EAN, JAN입니다.
• google_shopping은 Commerce Search가 돌려준 상품을 읽습니다. url에 검색어, Google 상품 ID, 상품명이 들어 있습니다. 같은 검색어로 Google Shopping을 다시 검색하고, 그 검색어에서 상품이 보이지 않으면 상품명으로 검색해 상품 패널을 열기 때문에 다른 쇼핑몰보다 오래 걸립니다. offers는 Google이 보여 주는 판매처 목록이고, Google이 최저가로 표시한 판매처가 첫 번째입니다. 각 판매처에는 seller, title(판매처의 상품명), url(판매처 상품 페이지), price, listPrice, currency, inStock이 있습니다. 상품의 price, listPrice, seller, inStock은 첫 판매처의 값입니다. reviewCount는 Google이 정확한 개수를 보여 줄 때(1,000개 미만)만 담습니다. 검색어와 상품명 어느 쪽에서도 상품이 보이지 않으면 PAGE_UNAVAILABLE로 끝납니다.
• 쇼핑몰이 404나 410으로 답하는 페이지(삭제된 상품 등)는 PAGE_UNAVAILABLE로 끝나고, 메시지에 쇼핑몰의 응답을 담습니다. 그 밖의 읽기 실패는 ENGINE_NO_RESULT입니다. 과금은 완료된 읽기마다 적용됩니다.

​

관련 문서

• Commerce Search
• 엔진 목록
• 크레딧과 한도