알리익스프레스
정규화된 스키마로 제공되는 알리익스프레스 — 다른 마켓플레이스와 같은 오퍼레이션, 파라미터, 응답 형태.
알리익스프레스에는 두 개의 surface가 있습니다. 이 페이지는 정규화된 쪽으로, 아마존·이베이·쇼피파이·
월마트가 돌려주는 것과 같은 SearchResult와 Product입니다. 파서 하나로 다섯 곳을 모두 읽습니다.
| 엔드포인트 | 반환 | 가격 | |
|---|---|---|---|
| search | GET|POST /v1/aliexpress/search | SearchResult | $0.001 |
| browse | GET|POST /v1/aliexpress/browse | SearchResult | $0.001 |
| categories | GET|POST /v1/aliexpress/categories | CategoryList | $0.001 |
| image-search | POST /v1/aliexpress/image-search | SearchResult | $0.001 |
| product | GET|POST /v1/aliexpress/product | Product | $0.001 |
옛 엔드포인트 — /aliexpress/keyword-search, /aliexpress/product-details,
/aliexpress/image-search — 는 그대로 응답하지만 지원이 중단될 예정이며, v1 URL이 없고
2026년 10월 20일에 종료됩니다. 더 이상 문서화하지 않으니 여기서 시작하세요. 이전 중이라면
버전 관리에 이름 대응표가 있습니다.
/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)을 싣지만 리뷰 행은
싣지 않습니다.