API支持的买家用户地区：韩国

分页搜索已注册产品列表。通过在现有商品列表分页搜索接口的端点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}&businessTypes={businessType}

 

Query String Parameter

Name	Required	Type	Description
vendorId	O	Number	卖家ID  酷澎分配给卖家的固有代码  ex) C00012345
nextToken		Number	页面  调用下一页的关键值  调用第一页时，不要输入或输入'1'
maxPerPage		Number	每页件数  默认值：10；最大值: 100
sellerProductId		Number	注册商品ID
sellerProductName		String	注册商品名  搜索注册商品名，20字以内
status		String	卖家商品状态 Parameter Name Status IN_REVIEW 审核中  SAVED 临时保存  APPROVING 待审核   APPROVED 已通过审核  PARTIAL_APPROVED 部分通过审核   DENIED 审核不通过  DELETED 商品已删除
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	结果代码  SUCCES/ERROR
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

URL API Name

GET_PRODUCTS_BY_QUERY