Brand Search

# 01

Summary

Brand Search

# 02

Details

Available buyer market: Korea

Search the Coupang Brand Library by brand name. Use this API to look up a brandId before specifying it in the Product Creation API.

Path

POST/v2/providers/seller_api/apis/api/v1/marketplace/brands/search

Example endpoint

https://api-gateway.coupang.com/v2/providers/seller_api/apis/api/v1/marketplace/brands/search

# 03

Request body

Request parameters

Body parameter

Name	Type	Description
brandName*	string	Brand search keyword
countPerPage	integer	Results per page. Default: 10, Max: 10 (values over 10 are capped)
page	integer	Page number. Default: 1, Min: 1 (values below 1 are corrected to 1)

Request exampleapplication/json

{
  "brandName": "NIKE",
  "countPerPage": 10,
  "page": 1
}

# 04

Response body

Response message

Name	Type	Description
code	string	Result code SUCCESS/ERROR
message	string	Result message
data	object
page data.page	integer	Applied page number
countPerPage data.countPerPage	integer	Applied page size
totalCount data.totalCount	integer	Total number of brands matching the search criteria
items data.items	object[]
brandId data.items[].brandId	string	Unique brand identifier (e.g. KR-5)
brandName data.items[].brandName	string	Brand name (e.g. NIKE)
brandLogoUrl data.items[].brandLogoUrl	string	Brand logo image URL
isUIDRequired data.items[].isUIDRequired	boolean	Whether UID submission is required
allowedUIDTypes data.items[].allowedUIDTypes	object[]	Allowed UID type list (e.g. GTIN, MPN)

Response Example

{
  "code": "SUCCESS",
  "message": "",
  "data": {
    "page": 1,
    "countPerPage": 10,
    "totalCount": 123,
    "items": [
      {
        "brandId": "KR-5",
        "brandName": "NIKE",
        "brandLogoUrl": "https://example.com/logo.png",
        "isUIDRequired": true,
        "allowedUIDTypes": [
          "GTIN",
          "MPN"
        ]
      }
    ]
  }
}

# 05

Error codes

HTTP	Code	Message
400	HTTP_400	Bad Request

Error specification

HTTP	Type	Error message	Solution
400	400 Bad Request	brandName is required	Include the required brandName parameter
401	401 Unauthorized	Authentication failed	Verify your HMAC authentication credentials