分页搜索已注册产品列表。通过在现有商品列表分页搜索接口的端点URL中添加参数，只能单独搜索Rocket Growth产品，新参数请参见绿色文字。
Path
GET
https://api-gateway.coupang.com/v2/providers/seller_api/apis/api/v1/marketplace/seller-products
Example endpoint
https://api-gateway.coupang.com/v2/providers/seller_api/apis/api/v1/marketplace/seller-products?vendorId={vendorId}&nextToken={nextToken}&maxPerPage={maxPerSize}&sellerProductId={sellerProductId}&sellerProductName={sellerProductName}&status={status}&manufacture={manufacture}&createdAt={createdAt}&businessType={businessType}
Query String Parameter
|
Name |
Required |
Type |
Description |
||||||||||||||||
|
vendorId |
O |
Number |
卖家ID 酷澎分配给卖家的固有代码 ex) C00012345
|
||||||||||||||||
|
nextToken |
|
Number |
页面 调用下一页的关键值 调用第一页时，不要输入或输入'1' |
||||||||||||||||
|
masPerPage |
|
Number
|
每页件数 默认值：10；最大值: 100 |
||||||||||||||||
|
sellerProductId |
|
Number |
注册商品ID |
||||||||||||||||
|
sellerProductName |
|
String |
注册商品名 搜索注册商品名，20字以内 |
||||||||||||||||
|
status |
|
String |
卖家商品状态
|
||||||||||||||||
|
manufacture |
|
String |
制造商
|
||||||||||||||||
|
createdAt |
|
String |
商品注册时间 格式"yyyy-MM-dd" Ex) Type in "2015-12-17" to query 2015-12-17T00:00:00 ~ 2015-12- 17T23:59:59 |
||||||||||||||||
|
businessTypes |
O |
String |
使用“rocketGrowth”参数时，将检索包含 Marketplace 和 Rocket Growth 商品的 Rocket Growth 商品或混合产品的列表。 如果不使用该参数，则根据现有格式搜索 Marketplace 商品或同时包含 Marketplace 和 Rocket Growth 商品的混合产品。 |
Request Example
Response Message
|
Name |
Type |
Description |
|||
|
code |
String |
结果代码 |
|||
|
message |
String |
|
|||
|
nextToken |
String |
下一页 如果没有下一页，则为空字符串 |
|||
|
data |
Array |
|
|||
|
|
sellerProductId |
String |
显示商品ID |
||
|
|
sellerProductName |
String
|
显示商品名 |
||
|
|
displayCategoryCode |
Number |
显示品类代码 |
||
|
|
categoryId |
Number
|
品类ID |
||
|
|
productId |
Number |
商品Id |
||
|
|
vendorId |
String |
卖家ID |
||
|
|
saleStartedAt |
String |
销售开始日期 格式为"yyyy-MM-dd'T'HH:mm:ss" *年份可选择至2099年 |
||
|
|
saleEndedAt
|
String |
销售结束日期 格式为"yyyy-MM-dd'T'HH:mm:ss" , *年份可选择至2099年 |
||
|
|
brand |
String |
品牌 输入品牌的韩文/英文标准名称 |
||
|
|
statusName |
String |
注册商品状态 审核中 / 临时保存 / 待审核 / 已审核 / 部分审核 / 审核被拒 / 商品已删除 |
||
|
|
createdAt |
String |
商品上架的日期/时间 格式为"yyyy-MM-dd'T'HH:mm:ss" |
||
|
|
items |
Array |
|
||
|
|
|
itemName
|
String |
卖家商品属性名 |
|
|
|
|
marketPlaceItemData |
|
物流公司代码 |
|
|
|
|
|
sellerProductItemId |
|
卖家商品属性ID |
|
|
|
|
vendorItemId |
|
属性ID 如果临时保存商品，则此值为空。商品审核通过将显示。 |
|
|
|
rocketGrowthItemData |
|
|
|
|
|
|
|
sellerProductItemId |
|
卖家商品属性ID |
|
|
|
|
vendorItemId |
|
属性ID 如果临时保存商品，则此值为空。商品审核通过将显示。 |
Response Example
Rocket Growth 상품
{
"code": "SUCCESS",
"message": "",
“nextToken”:” 30100307028”,
"data": [
{
"items": [
{
"itemName": "RED",
"marketPlaceItem": null,
"rocketGrowthItem": {
"vendorInventoryItemId": 30100601902,
"vendorItemId": 123333333
}
}
],
"sellerProductId": 30100307028,
"sellerProductName": "RG test",
"displayCategoryCode": 78361,
"categoryId": 2357,
"productId": null,
"vendorId": "A00159255",
"mdId": null,
"mdName": null,
"saleStartedAt": "2024-06-26T09:00:00",
"saleEndedAt": "2099-12-31T09:00:00",
"brand": "",
"statusName": "승인반려",
"createdAt": "2024-06-26T13:58:37",
"registrationType": "RFM"
},
]
}
Rocket Growth / Marketplace 동시 운영 상품
{
"code": "SUCCESS",
"message": "",
“nextToken”:” 30100307028”,
"data": [
{
"items": [
{
"itemName": "RED",
"marketPlaceItem": {
"vendorInventoryItemId": 30100601907,
"vendorItemId": 72300272939
},
"rocketGrowthItem": {
"vendorInventoryItemId": 30100601908,
"vendorItemId": 72300272940
}
}
],
"sellerProductId": 30100307032,
"sellerProductName": "Hybrid Success",
"displayCategoryCode": 98910,
"categoryId": 7652,
"productId": 2461309585,
"vendorId": "A00159255",
"mdId": null,
"mdName": null,
"saleStartedAt": "2024-06-27T09:00:00",
"saleEndedAt": "2099-12-31T09:00:00",
"brand": "",
"statusName": "승인완료",
"createdAt": "2024-06-27T10:08:28",
"registrationType": "NORMAL"
}
]
}
Error Spec
| HTTP status code (error type) | Error message | How to resolve |
|---|---|---|
|
400 (check request parameter) |
卖家代码必须输入。 |
查看卖家 ID (vendorId) 是否输入正确。 |
|
400 (check request parameter) |
createdAt的格式是`yyyy- MM-dd` |
查看输入的商品注册日期 (createdAt) 值是否输入正确。格式要为“yyyy-MM-dd”。 |
URL API Name
GET_PRODUCTS_BY_QUERY