商品 API 品類 API 品牌 API 運輸 / 訂單 API 退貨 API 換貨 API 促銷 / 優惠券物流資訊客服 / 諮詢結算 CGF / CGF lite Rocket Growth

Rocket Growth

GET/v2/providers/seller_api/apis/api/v1/marketplace/seller-products2609170000

Product list paging query (Rocket Growth & Rocket Growth/Marketplace Hybrid Products)

KRTW

# 01

簡介

# 02

詳細內容

Available buyer market: Korean

Paging the registered product list. By adding a parameter to the endpoint URL of the existing product list paging API, you can search only Rocket Growth products separately. Please refer to the green text for the new parameter.

路徑

GET/v2/providers/seller_api/apis/api/v1/marketplace/seller-products

範例端點

https://api-gateway.coupang.com/v2/providers/seller_api/apis/api/v1/marketplace/seller-products?vendorId={vendorId}&nextToken={nextToken}&maxPerPage={maxPerPage}&sellerProductId={sellerProductId}&sellerProductName={sellerProductName}&status={status}&manufacture={manufacture}&createdAt={createdAt}&businessTypes={businessTypes}

URL API Name

GET_PRODUCTS_BY_QUERY

# 03

Query 參數

Name	Type	Description
vendorId*	string	Seller ID issued by Coupang. Example: A00012345
nextToken	integer	Key used to call the next page. Omit it or enter 1 for the first page.
maxPerPage	integer	Items per page. Default: 10, maximum: 100.
sellerProductId	integer	Listed product ID
sellerProductName	string	Listed product name. Search is limited to 20 characters.
status	string	Seller product status
manufacture	string	Manufacturer
createdAt	string	Product registration date. Enter it in yyyy-MM-dd format.
businessTypes*	array	When the "rocketGrowth" parameter is used, returns Rocket Growth products or Hybrid products containing both Marketplace and Rocket Growth items. When omitted, returns Marketplace products or Hybrid products containing both Marketplace and Rocket Growth items according to the existing format.

# 04

回應內容

回應訊息

Name

Type

Description

code

string

Result code

SUCCES/ERROR

message

string

nextToken

string

Next page

Null sstring if the next page is unavailable

data

object[]

sellerProductId

data[].sellerProductId

integer

Listed product id

sellerProductName

data[].sellerProductName

string

Listed product Name

displayCategoryCode

data[].displayCategoryCode

integer

Display category code

categoryId

data[].categoryId

integer

Category ID

productId

data[].productId

number

ProductId

vendorId

data[].vendorId

string

Seller ID

saleStartedAt

data[].saleStartedAt

string

Date/time of starting selling
"yyyy-MM-dd'T'HH:mm:ss" format, *can input up to 2099

saleEndedAt

data[].saleEndedAt

string

Ending date of sales
"yyyy-MM-dd'T'HH:mm:ss" format, *can input up to 2099

brand

data[].brand

string

Brand
Input official brand name in Korean/ English

statusName

data[].statusName

string

Status of registered product
심사중/ 임시저장/ 승인대기중/ 승인완료/ 부분승인완료/ 승인반려/ 상품삭제

The corresponding meanings are Under review / Temporarily saved / Awaiting approval / Approved / Partially approved / Approval denied / Product deleted

Parameter Name	Status
IN_REVIEW
SAVED
APPROVING
APPROVED
PARTIAL_APPROVED
DENIED
DELETED

createdAt

data[].createdAt

string

Date/time of product listing
"yyyy-MM-dd'T'HH:mm:ss" format,

items

data[].items

object[]

itemName

data[].items[].itemName

string

Vendor item option name

marketPlaceItemData

data[].items[].marketPlaceItemData

object

Courier code
Link for courier codes

sellerProductItemId

data[].items[].marketPlaceItemData.sellerProductItemId

object

Vendor item option ID

vendorItemId

data[].items[].marketPlaceItemData.vendorItemId

object

Option ID
This value will be null if item is temporarily saved. It will be displayed after item is approved.

rocketGrowthItemData

data[].items[].rocketGrowthItemData

object

sellerProductItemId

data[].items[].rocketGrowthItemData.sellerProductItemId

object

Vendor item option ID

vendorItemId

data[].items[].rocketGrowthItemData.vendorItemId

object

Option ID
This value will be null if item is temporarily saved. It will be displayed after item is approved.

Response Example

{
  "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"
    }
  ]
}

# 05

錯誤碼

HTTP	代碼	訊息
400	HTTP_400	Bad Request

錯誤說明

HTTP	類型	錯誤訊息	解決方案
400	400 (check request parameter)	Vendor code must be entered.	Check if the seller ID (vendorId) is correct.
400	400 (check request parameter)	Format of createdAt is `yyyy-MM-dd`	Check the format of product listing date/time (createdAt): It must be "yyyy-MM-dd."