Products Categories Brands Shipments & Orders Returns Exchanges Promotions & Coupons Logistics Info Customer Service Settlement 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)

# 01

Summary

# 02

Details

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.

Path

GET

https://api-gateway.coupang.com/v2/providers/seller_api/apis/api/v1/marketplace/seller-products

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}&businessTypes={businessType}

URL API Name

GET_PRODUCTS_BY_QUERY

# 03

Response body

Response message

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

# 04

Error codes

HTTP	Code	Message
400	HTTP_400	Bad Request

Error specification

HTTP	Type	Error message	Solution
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."