상품 키워드 검색 API
POST /v1/products/search — 키워드 검색을 수행하고 페이지네이션된 상품 목록을 반환합니다.
관련 문서: Product detail · Product response models
요청 본문
| 필드 | 필수 | 설명 |
|---|---|---|
channel | 예 | 1688 | taobao |
keyword | 예 | 검색어 |
page / page_size | 아니요 | 페이지네이션(Taobao는 페이지당 최대 20개) |
language | 아니요 | 기본값 en |
filter / sort | 아니요 | 1688 필터(OpenAPI 참고) |
예시
POST /v1/products/search
{
"channel": "1688",
"keyword": "phone case",
"page": 1,
"page_size": 20,
"language": "en"
}응답
StandardProductList — items[]에 요약 카드가 들어 있습니다. 전체 SKU 매트릭스와 재고는 product detail을 호출하세요.