Amazon
16개 Amazon 마켓플레이스를 공통 마켓플레이스 스키마로 제공합니다. `region`으로 마켓플레이스를 고르면, 가격은 그 마켓플레이스의 통화로 옵니다.
오퍼레이션
| 오퍼레이션 | 엔드포인트 | 반환 | 가격 |
|---|---|---|---|
| Search | GET | POST /v1/amazon/search | SearchResult | $0.001–$0.002 |
| Image Search | POST /v1/amazon/image-search | SearchResult | $0.001–$0.002 |
| Browse | GET | POST /v1/amazon/browse | SearchResult | $0.001–$0.002 |
| Categories | GET | POST /v1/amazon/categories | CategoryList | $0.001 |
| Product | GET | POST /v1/amazon/product | Product | $0.002–$0.032 |
reviews는 없습니다. Amazon 리뷰는 제공되지 않습니다.
마켓플레이스
region | 사이트 | 통화 |
|---|---|---|
US (기본값) | amazon.com | USD |
CA | amazon.ca | CAD |
MX | amazon.com.mx | MXN |
BR | amazon.com.br | BRL |
FR | amazon.fr | EUR |
IT | amazon.it | EUR |
ES | amazon.es | EUR |
NL | amazon.nl | EUR |
SE | amazon.se | SEK |
TR | amazon.com.tr | TRY |
AE | amazon.ae | AED |
SA | amazon.sa | SAR |
IN | amazon.in | INR |
JP | amazon.co.jp | JPY |
SG | amazon.sg | SGD |
AU | amazon.com.au | AUD |
모든 오퍼레이션이 모든 마켓플레이스에서 동작하며, 알아둘 차이는 세 가지입니다.
- 언어. 텍스트 필드(제목, 배송·재고 문구)는 사이트가 영어를 제공하면 영어로 옵니다. amazon.com.mx, amazon.com.br, amazon.com.tr은 스페인어·포르투갈어·터키어만 제공하므로 텍스트 필드가 해당 언어로 옵니다. 가격, 평점, 리뷰 수, 무료배송 여부는 다른 곳과 똑같이 정규화됩니다.
- amazon.fr은
ratingMin,brands,facets,include=facets를 받지 않으며(파라미터 이름을 밝힌 400),browse결과에facets가 없습니다. - 카테고리 id는 마켓플레이스별입니다. 한 마켓플레이스의
categories에서 받은 browse 노드는 다른 마켓플레이스에서 의미가 없습니다. browse할 때와 같은region으로categories를 탐색하세요.
아래 채움률은 amazon.com에서 측정한 값입니다.
실제로 도착하는 것
스키마상으로는 선택 필드입니다. Amazon이 실제로 채우는 비율은 다음과 같습니다.
검색 아이템
| 필드 | 채움률 |
|---|---|
title url | ~99% |
imageUrl | ~98% |
price | ~90% |
rating.average rating.count | ~90% |
delivery | ~80% |
shippingOptions (두 번째, 더 빠른 옵션) | ~70% |
salesLabel | ~50% |
상품
| 필드 | 채움률 |
|---|---|
title | 100% |
media.images | ~95% |
brand rating.average rating.distribution features description attributes reviews | ~90% |
price status seller.name | ~85% |
category delivery groupId offers | ~80% |
reviewSummary returnsPolicy | ~70% |
reviewAspects brandUrl | ~60% |
상세 화면에서는 Amazon이 이 중 가장 풍부합니다 — reviewSummary, reviewAspects,
rating.distribution, offers는 여기서 도착하고 다른 곳에서는 대체로 도착하지 않습니다. price가
100%가 아닌 이유는 리스팅에 현재 판매 오퍼가 정말로 없을 수 있기 때문입니다. 그것은 price가 없는
것이지 0이 아닙니다.
Amazon에만 해당하는 것
변형을 따로 조회할 수 있습니다. 색상이나 사이즈마다 고유한 ASIN이 있으므로 모든 variant가
product에 그대로 넘길 수 있는 productId를 가지며, groupId가 패밀리를 가리킵니다. Shopify와
Walmart는 반대 방식입니다.
평점이 변형이 아니라 패밀리를 설명할 수 있습니다. 변형 패밀리의 모든 형제가 같은 집계를
보고합니다 — 실측으로 한 셔츠의 변형 62개가 모두 4.6 / 334,685를 보고했습니다. 이것이 감지되면 응답에
rating.grouped: true가 설정됩니다.
브랜드 스토어 페이지에는 카테고리가 없습니다. 애플과 Amazon 디바이스 페이지에는 브레드크럼도
베스트셀러 순위도 없으므로, category는 누락이 아니라 정당하게 []입니다.