---
title: "Amazon"
description: "16개 Amazon 마켓플레이스를 공통 마켓플레이스 스키마로 제공합니다. `region`으로 마켓플레이스를 고르면, 가격은 그 마켓플레이스의 통화로 옵니다."
---

## 오퍼레이션

| 오퍼레이션 | 엔드포인트 | 반환 | 가격 |
|---|---|---|---|
| [Search](/docs/api-reference/amazon/search) | `GET \| POST /v1/amazon/search` | `SearchResult` | $0.001–$0.002 |
| [Image Search](/docs/api-reference/amazon/image-search) | `POST /v1/amazon/image-search` | `SearchResult` | $0.001–$0.002 |
| [Browse](/docs/api-reference/amazon/browse) | `GET \| POST /v1/amazon/browse` | `SearchResult` | $0.001–$0.002 |
| [Categories](/docs/api-reference/amazon/categories) | `GET \| POST /v1/amazon/categories` | `CategoryList` | $0.001 |
| [Product](/docs/api-reference/amazon/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`는 누락이 아니라 정당하게 `[]`입니다.