酷澎品类推荐API是一项在卖家输入商品信息（商品名、品牌、属性等）后，查找并推荐与之最匹配的酷澎品类（displayCategoryCode）的服务。
品类推荐 API 是一种机器学习模型，其系统会学习之前注册商品的酷澎品类。
如果输入的信息不正确，则推荐的品类也可能会不正确。
创建商品时，卖家可选择是否使用品类推荐API的结果数据。
各品类酷澎收取的手续费不同，选择品类时请注意。
品类推荐API未能提供准确的结果值时，酷澎不承担由此带来的损失。
◼ 品类推荐API示例:
输入信息：输入信息：“[Yuhan] Yuhan Zen洗衣粉1kg容器（杀菌漂白剂）x 10个”
酷澎品类推荐API首先会查找最接近输入信息的大范围品类“生活用品”。
然后，查找子品类“洗涤剂”并继续在内部查找适合该商品的子品类，最后建议将其划分为“生活用品>洗涤剂>洗衣粉>漂白剂>粉末状”品类。
|
输入信息 |
推荐结果 |
|
[Yuhan] Yuhan Zen 洗衣粉1kg容器（杀菌漂白剂） x10个 |
生活用品>洗涤剂>洗衣粉>漂白剂>粉末状(5depth leaf catecode: 63955) |
|
[Yuhan] Yuhan Zen 洗衣液1.8L替换装（杀菌漂白剂） |
生活用品>洗涤剂>洗衣粉>漂白剂>液态(5depth leaf catecode: 63954) |
|
[Yuhan] Yuhan Clorox power gel 1L (杀菌/除异味)x10个 |
生活用品>洗涤剂>清洁剂>Clorox/杀菌消毒剂(4depth leaf catecode: 63922) |
由于该模型完全依赖于所输入的信息，所以想要获得准确的推荐结果，就必须输入清晰且足够详细的商品信息。
例如，与上方示例不同，如果将输入信息简化为"[Yuhan] Yuhan Zen (杀菌漂白剂)"，则缺少了了解商品类型的必要信息，无法清楚得知该商品为粉末状洗涤剂还是液体洗涤剂。所以，所推荐的品类可能会不正确。
或者，如果在一件商品中同时输入两个难以分辨是粉末状还是液态的含糊关键词，例如" [Yuhan] Yuhan Zen liquid/powder(杀菌漂白剂)", 所推荐的品类也可能会出现错误。
因此，使用酷澎品类推荐API时，请注意以下事项。
1．请在商品名中输入详细的商品信息，尽可能地展示商品特征。
不推荐的商品名示例：“圆形T恤 gn 95 aden Green系列”
若为时装类商品，建议至少在商品名中标明适合女士/男士/男女同款。
此外，比起仅标注”圆领T恤”这一关键词，如果您在商品名中一同输入该商品是运动衫、连帽 T 恤、长袖还是短袖等信息的话，我们可以更准确地帮助您进行商品分类。
推荐的商品名示例：”圆领T恤男士长袖运动衫gn 95 aden Green 系列”
2.请注意不要在一个商品名中输入不同类型的商品。如果您输入了错误的关键词，则推荐的品类也可能会不正确。
不推荐的商品名示例: “宠物狗行李箱宠物狗玩具宠物狗衣服牵引绳”
在上述情况中，即使人工判断也很难通过商品名预测出商品类型，自然酷澎品类推荐API也无法准确推荐。
请注意不要以Deal的形式注册商品名，并区分搜索关键词与商品名，确保输入的商品名正确无误。
推荐的商品名示例: “宠物狗自动牵引绳”
Path
POST
/v2/providers/openapi/apis/api/v1/categorization/predict
Example Endpoint
https://api-gateway.coupang.com/v2/providers/openapi/apis/api/v1/categorization/predict
Request Parameters
Body Parameter
| Name | Required | Type | Description | ||||
|---|---|---|---|---|---|---|---|
| productName | O | String |
商品名 |
||||
| productDescription | String |
商品详细说明 |
|||||
| brand | String |
品牌 |
|||||
| attributes | Array |
商品属性信息 (例：尺寸、颜色、材质等) |
|||||
| sellerSkuCode | String |
卖家商品编号(企业商品编号) |
|||||
Request Example
{
"productName": "코데즈컴바인 양트임싱글코트",
"productDescription": "모니터 해상도, 밝기, 컴퓨터 사양 등에 따라 실물과 약간의 색상차이가 있을 수 있습니다. 캐주얼하지만 큐티한디자인이 돋보이는 싱글코트에요 약간박시한핏이라 여유있고 편하게 스타일링하기 좋은 캐주얼 싱글코트입니다. 컬러:베이지,네이비 사이즈:FREE 실측(측정자,측정기준,제작과정에따라 다소차이가있을수있습니다) 단면기준 CM 단위 가슴단면:61 어깨:54 팔기장:55(어깨절개선기준) 총장:88",
"brand": "코데즈컴바인",
"attributes": {
"제품 소재": "모달:53.8 폴리:43.2 레이온:2.4 면:0.6",
"색상": "베이지,네이비",
"제조국": "한국"
},
"sellerSkuCode": "123123"
}Response Message
| Name | Type | Description | ||||
|---|---|---|---|---|---|---|
| code | Number |
HTTP Status Code |
||||
| message | String |
HTTP Status message |
||||
| data | Object |
|
||||
| autoCategorizationPredictionResultType | String |
结果类型 (SUCCESS, FAILURE, INSUFFICIENT_INFORMATION) |
||||
| comment | String |
评论 |
||||
| predictedCategoryId | String |
推荐品类ID (displayCategoryCode) |
||||
| predictedCategoryName | String |
推荐品类名 |
||||
Response Example
{
"code": 200,
"message": "OK",
"data": {
"autoCategorizationPredictionResultType": "SUCCESS",
"predictedCategoryId": "63950",
"predictedCategoryName": "일반 섬유유연제",
"comment": null
}
}
Error Spec
| HTTP Status Code (Error Type) | Error Message | Solution |
|---|---|---|
|
400 (确认请求参数)
|
Input product name should not be empty! |
请确认您输入的商品名(productName)是否完整。 |
|
500 (服务器错误) |
Internal Server Error |
请确认您输入的商品名(productName)是否完整。 |
|
500 (服务器错误) |
Error occurred when communicating with seller_intelligence domain service. vendorId = A00123456, productName = ******** .. |
预测推荐品类时发生错误。请稍后重试或修改输入值。 |
|
500 (服务器错误) |
Fail to communicate with the downstream domain services (catalog prediction service) |
请稍后重试或修改输入值。 |
|
500 (服务器错误) |
Fail to communicate with the listing domain to retrieve category name |
请稍后重试或修改输入值。 |
|
500 (服务器错误) |
Receive error message from the downstream domain services (catalog prediction service) |
请稍后重试或修改输入值。 |
URL API Name
GET_PRODUCT_AUTO_CATEGORY