coupang
GET/v2/providers/seller_api/apis/api/v1/marketplace/meta/display-categories2609170000

How to get category list

# 01

Summary

How to get category list

# 02

Details

Available buyer market: Korean

Get the list of all display categories.

Download the category list in an excel file

Path

GET/v2/providers/seller_api/apis/api/v1/marketplace/meta/display-categories

Example endpoint

https://api-gateway.coupang.com/v2/providers/seller_api/apis/api/v1/marketplace/meta/display-categories
# 03

Response body

Response message

NameTypeDescription
codestring
results code
SUCCESS/ERROR
messagestring
message
dataobject
list of display categories (also known as exposed categories)
repeats N times, as many as the resulting display categories
displayItemCategoryCode
data.displayItemCategoryCode
integer
name
data.name
string
display category name
repeats N times, as many as the resulting display categories
status
data.status
string
display category status
Status Description
ACTIVE in service
READY not yet in service (coming soon)
DISABLED not in service
child
data.child
object[]
it's a sub-category that is displayed to the customers
if there's none, []
category info is identical
displayItemCategoryCode
data.child[].displayItemCategoryCode
integer
name
data.child[].name
string
see above
status
data.child[].status
string
see above
child
data.child[].child
object[]
display sub-category
displayItemCategoryCode
data.child[].child[].displayItemCategoryCode
integer
name
data.child[].child[].name
string
status
data.child[].child[].status
string
child
data.child[].child[].child
object[]
displayItemCategoryCode
data.child[].child[].child[].displayItemCategoryCode
integer
name
data.child[].child[].child[].name
string
status
data.child[].child[].child[].status
string
child
data.child[].child[].child[].child
object[]
displayItemCategoryCode
data.child[].child[].child[].child[].displayItemCategoryCode
integer
name
data.child[].child[].child[].child[].name
string
status
data.child[].child[].child[].child[].status
string
child
data.child[].child[].child[].child[].child
object[]
displayItemCategoryCode
data.child[].child[].child[].child[].child[].displayItemCategoryCode
integer
name
data.child[].child[].child[].child[].child[].name
string
status
data.child[].child[].child[].child[].child[].status
string
child
data.child[].child[].child[].child[].child[].child
object[]

Response Example

{
  "code": "SUCCESS",
  "message": "",
  "data": {
    "displayItemCategoryCode": 0,
    "name": "ROOT",
    "status": "ACTIVE",
    "child": [
      {
        "displayItemCategoryCode": 69182,
        "name": "패션의류잡화",
        "status": "ACTIVE",
        "child": [
          {
            "displayItemCategoryCode": 69183,
            "name": "여성패션",
            "status": "ACTIVE",
            "child": [
              {
                "displayItemCategoryCode": 69184,
                "name": "여성의류",
                "status": "ACTIVE",
                "child": [
                  {
                    "displayItemCategoryCode": 79268,
                    "name": "티셔츠",
                    "status": "ACTIVE",
                    "child": [
                      {
                        "displayItemCategoryCode": 79383,
                        "name": "민소매/나시",
                        "status": "ACTIVE",
                        "child": []
                      },
                      {
                        "displayItemCategoryCode": 79382,
                        "name": "반소매",
                        "status": "ACTIVE",
                        "child": []
                      },
                      {
                        "displayItemCategoryCode": 79381,
                        "name": "긴소매",
                        "status": "ACTIVE",
                        "child": []
                      }
                    ]
                  },
                  {
                    "displayItemCategoryCode": 69186,
                    "name": "맨투맨",
                    "status": "ACTIVE",
                    "child": []
                  },
                  {
                    "displayItemCategoryCode": 79269,
                    "name": "후드티",
                    "status": "ACTIVE",
                    "child": []
                  },
                  {
                    "displayItemCategoryCode": 69187,
                    "name": "블라우스",
                    "status": "ACTIVE",
                    "child": []
                  },
                  {
                    "displayItemCategoryCode": 69188,
                    "name": "셔츠(남방)",
                    "status": "ACTIVE",
                    "child": []
                  },
                  {
                    "displayItemCategoryCode": 86393,
                    "name": "양봉용품",
                    "status": "ACTIVE",
                    "child": [
                      {
                        "displayItemCategoryCode": 86389,
                        "name": "양봉의류",
                        "status": "ACTIVE",
                        "child": []
                      },
                      {
                        "displayItemCategoryCode": 86390,
                        "name": "양봉모자/잡화",
                        "status": "ACTIVE",
                        "child": []
                      },
                      {
                        "displayItemCategoryCode": 86391,
                        "name": "벌통",
                        "status": "ACTIVE",
                        "child": []
                      },
                      {
                        "displayItemCategoryCode": 86392,
                        "name": "양봉용 자재",
                        "status": "ACTIVE",
                        "child": []
                      }
                    ]
                  }
                ]
              }
            ]
          }
        ]
      }
    ]
  }
}
# 04

Error codes

HTTPCodeMessage
--