---
title: "알리익스프레스"
description: "정규화된 스키마로 제공되는 알리익스프레스 — 다른 마켓플레이스와 같은 오퍼레이션, 파라미터, 응답 형태."
---

알리익스프레스에는 **두 개의 surface**가 있습니다. 이 페이지는 정규화된 쪽으로, 아마존·이베이·쇼피파이·
월마트가 돌려주는 것과 같은 `SearchResult`와 `Product`입니다. 파서 하나로 다섯 곳을 모두 읽습니다.

| | 엔드포인트 | 반환 | 가격 |
|---|---|---|---|
| [search](/docs/api-reference/aliexpress/search) | `GET\|POST /v1/aliexpress/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 |
| [image-search](/docs/api-reference/aliexpress/image-search) | `POST /v1/aliexpress/image-search` | `SearchResult` | $0.001 |
| [product](/docs/api-reference/aliexpress/product) | `GET\|POST /v1/aliexpress/product` | `Product` | $0.001 |

옛 엔드포인트 — `/aliexpress/keyword-search`, `/aliexpress/product-details`,
`/aliexpress/image-search` — 는 그대로 응답하지만 **지원이 중단될 예정**이며, v1 URL이 없고
**2026년 10월 20일**에 종료됩니다. 더 이상 문서화하지 않으니 여기서 시작하세요. 이전 중이라면
[버전 관리](/docs/versioning)에 이름 대응표가 있습니다.

**`/v1/aliexpress/image-search`와 `/aliexpress/image-search`는 서로 다른 엔드포인트입니다.** 버전이 붙은
쪽이 아래에 문서화된 정규화 비주얼 검색입니다. 버전 없는 쪽은 옛 방언이며 응답 형태가 알리익스프레스
자신의 것입니다 — 같은 세그먼트, 다른 본문. v1 밖에서는 정규화된 비주얼 검색이 옛 이름
`/aliexpress/visual-search`를 유지합니다. 거기서는 정식 세그먼트가 이미 쓰이고 있었기 때문입니다. v1
안에서는 그 방언이 아예 없으므로 정식 이름이 비어 있습니다.

## 알리익스프레스에만 해당하는 것

**변형을 따로 조회할 수 없습니다.** 사이즈나 색상은 하나의 상품 안에 있는 SKU이므로
`variant.productId`가 없습니다. 한 번의 호출로 SKU별 가격과 재고를 포함한 변형 전체를 받습니다.

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

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