COMMERCE_SERP(site: coupang)를 보내면 검색 결과의 상품을 쇼핑몰 순서대로 받습니다. 이 쇼핑몰의 상품 페이지는 COMMERCE_PRODUCT로 읽지 않습니다. 완료된 검색당 2크레딧입니다.
검색
GET /v1/async/task/{id}를 폴링하거나 웹훅으로 받습니다. 참고: 비동기 task.
입력
site: 필수.coupang입니다.query: 필수. 검색어이며 1-500자입니다.limit: 선택. 정수 1-40이며 기본값은 20입니다.country: 선택. 기본값은 쇼핑몰의 국가인KR입니다. 다른 국가는422 REGION_UNSUPPORTED로 거절합니다.
include는 생략합니다. include: {}도 크레딧을 확보하기 전에 payload.include의 422 VALIDATION_ERROR를 반환합니다.
결과 필드
site,query,country는 요청 값입니다.returnedCount는products에 담긴 상품 수입니다.- 각 상품은
rank,productId,title,url을 담습니다.productId는 쇼핑몰 자체 상품 ID입니다.rank는 쇼핑몰의 기본 정렬 순서이며, 광고 상품도 화면에 나온 자리 그대로 담습니다. price,rating,reviewCount,imageUrl필드는 검색 결과 화면에 있을 때 담습니다.price는 상품별currency(ISO 4217) 기준의 숫자이며, 용량별 가격이 다르면 가장 낮은 가격입니다.rating은 5점 만점입니다. 999+처럼 줄여 표시한 리뷰 수는 담지 않습니다.- 검색마다 쇼핑몰의 첫 결과 페이지에서 상품을 가져옵니다.
오류와 과금
- 상품이 하나도 없는 검색은 실패한 task로 끝납니다.
- 완료된 검색에만 과금하며, 검색당 2크레딧입니다.