---
title: "AliExpress"
description: "AliExpress를 공통 마켓플레이스 스키마로 제공합니다. 모든 마켓플레이스와 같은 `SearchResult`와 `Product`에 더해 배송 견적을 돌려줍니다."
---

> Every apinoa docs page as markdown: https://apinoa.com/llms.txt (all in one file: https://apinoa.com/llms-full.txt; this API family in one file: https://apinoa.com/docs/marketplace/llms.txt)

## 오퍼레이션

| 오퍼레이션 | 엔드포인트 | 반환 | 가격 |
|---|---|---|---|
| [Search](/docs/api-reference/aliexpress/search) | `GET \| POST /v1/aliexpress/search` | `SearchResult` | $0.001 |
| [Image Search](/docs/api-reference/aliexpress/image-search) | `POST /v1/aliexpress/image-search` | `SearchResult` | $0.001 |
| [Browse](/docs/api-reference/aliexpress/browse) | `GET \| POST /v1/aliexpress/browse` | `SearchResult` | $0.001 |
| [Categories](/docs/api-reference/aliexpress/categories) | `GET \| POST /v1/aliexpress/categories` | `CategoryList` | $0.001 |
| [Product](/docs/api-reference/aliexpress/product) | `GET \| POST /v1/aliexpress/product` | `Product` | $0.001–$0.002 |
| [Shipping](/docs/api-reference/aliexpress/shipping) | `GET \| POST /v1/aliexpress/shipping` | `ShippingQuote` | $0.001–$0.002 |

AliExpress의 옛 엔드포인트(`/aliexpress/keyword-search`, `/aliexpress/product-details`, 버전 없는 `/aliexpress/image-search`)는 지원이 중단되었고 `v1` URL이 없습니다. 각각의 대체 엔드포인트는 [Versioning](/docs/versioning)에 있습니다.

## AliExpress에만 해당하는 것

**변형을 따로 조회할 수 없습니다.** 사이즈나 색상은 하나의 상품 안에 있는 SKU이므로
`variant.productId`가 없습니다. 한 번의 호출로 SKU별 가격과 `stock`(숫자)을 포함한 변형 전체를 받습니다.
변형의 `id`는 AliExpress의 숫자 SKU id이며, `shipping`이 받는 값이 바로 이것입니다.

**상품 하나에 id 하나.** AliExpress는 일부 상품을 두 가지로 표기합니다(키워드 검색에서는 `3256…`,
그 밖에서는 `1005…`). 모든 응답은 전역 `1005…` 형식을 쓰며, 입력으로는 둘 다 받습니다.

**배송은 요청할 때만 받는 견적입니다.** `product?include=shipping`은 `delivery`(`region`까지 가장 저렴한
옵션)와 `shippingOptions`(모든 옵션)를 더합니다. [shipping](/docs/api-reference/aliexpress/shipping)은
어떤 변형·수량이든 따로 견적합니다. 이를 쓰지 않아도 `delivery.handlingDays`가 판매자의 발송 소요일을
알려 줍니다.

**상품에는 AliExpress가 밝히는 모든 것이 담깁니다.** 이름이 붙은 카테고리 경로, `package` 무게(크기는
포장의 `ext`), 스토어의 `country`(스토어 평점 세 가지는 판매자의 `ext.detailedRatings`), 변형별
`purchaseLimit`(`bulkPrice`·`taxIncluded`는 변형의 `ext`), 그리고 상품 `ext`의 `wholesale`. 가격 기본
통화는 USD입니다.

**가격 필터는 어느 변형이든 하나만 맞으면 됩니다.** AliExpress 상품은 가격 범위를 갖는 경우가 많고,
필터는 *어느* 변형이라도 구간에 들어가면 그 상품을 통과시킵니다 — 그런데 카드에는 최저("부터") 가격이
표시됩니다. 그래서 `priceMin=40` 요청이 $50짜리 변형 때문에 통과한, $28이 표시되는 행을 돌려줄 수
있습니다. 돌아온 행의 약 90~95%가 구간 안에 들어옵니다. 엄격한 경계가 필요하다면 돌아온 `price`를 직접
거르세요.

**리뷰 오퍼레이션은 없습니다.** 상품은 집계 평점(`rating.average`, `rating.count`)을 싣지만 리뷰 행은
싣지 않습니다.