coupang
API 文档
商品 API品类 API品牌 API运输 / 订单 API退货 API换货 API促销 / 优惠券物流信息客服 / 咨询结算CGF / CGF liteRocket Growth
GET/v2/providers/seller_api/apis/api/v1/marketplace/seller-productsv1

商品列表分页查询

# 01

简介

API支持的买家用户地区：韩国 台湾 支持分页的形式 查看注册商品列表。

# 02

详细内容

API支持的买家用户地区：韩国 台湾
支持分页的形式查看注册商品列表。 

Path

GET

/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}&violationTypes=ATTR&violationTypes=MOTA_V2&violationTypeAndOr=OR


 

Request Parameters

Query String Parameter

Name Required Type Description
vendorId O String

卖家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 
ViolationTypeSearchField   List

  • NO_VA_V2：需要验证商品信息的商品（限制展示）

  • MOTA_V2：缺失必填购买选项值的商品（限制展示）

  • ATTR：属性无效的商品（低曝光）
ViolationTypeAndOr   String

逻辑关系 (Logical Operator)

  • 说明： 当在 ViolationTypeSearchField 字段中输入**多个参数（2个及以上）**时，必须填写此字段。

  • 可选值：

    • AND (与 / 同时满足)

    • OR (或 / 满足其一即可)

Request Example

not require body

Response Message

Name Type Description
code Number

结果代码 

SUCCESS/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-ddTHH:mm:ss" 
  saleEndedAt String

销售结束时间 

"yyyy-MM-ddTHH:mm:ss" 
  brand String
品牌
  statusName String
注册商品状态 
Parameter Name Status
IN_REVIEW 审核中 
SAVED 临时保存 
APPROVING 待审核  
APPROVED 已通过审核 
PARTIAL_APPROVED 部分通过审核  
DENIED 审核不通过 
DELETED 商品已删除 
  createdAt String

注册销售的时间 

"yyyy-MM-ddTHH:mm:ss" 

Response Example

{
  "code": "SUCCESS",
  "message": "",
  "nextToken": "2",
  "data": [
    {
      "sellerProductId": 239092172,
      "sellerProductName": "R07 헬로키티 미니낚시놀이",
      "displayCategoryCode": 77413,
      "categoryId": 2102,
      "productId": 14784194,
      "vendorId": "XXXXXXXX",
      "mdId": "harry867@",
      "mdName": null,
      "saleStartedAt": "2017-02-14T06:00:00",
      "saleEndedAt": "2099-12-31T00:00:00",
      "brand": "상세설명별도참조",
      "statusName": "승인완료",
      "createdAt": "2017-02-13T02:09:47"
    },
    {
      "sellerProductId": 239092161,
      "sellerProductName": "R07 러닝리소스 손가락 지시봉 (10개 세트) (LER2657) - 러닝리소스 지시봉 손가락 포인터 장난감",
      "displayCategoryCode": 77413,
      "categoryId": 2102,
      "productId": 14784126,
      "vendorId": "XXXXXXXX",
      "mdId": "harry867@",
      "mdName": null,
      "saleStartedAt": "2017-02-14T06:00:00",
      "saleEndedAt": "2099-12-31T00:00:00",
      "brand": "상세설명별도참조",
      "statusName": "승인완료",
      "createdAt": "2017-02-13T02:09:46"
    }
  ]
}

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