Coupang Developer Center

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

Request Parameters

Body Parameter

Name	Required	Type	Description
brandName	O	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 Example

{

"brandName": "NIKE",

"countPerPage": 10,

"page": 1

}

Response Message

Name			Type	Description
code			String	Result code SUCCESS/ERROR
message			String	Result message
data			Object
	page		Integer	Applied page number
	countPerPage		Integer	Applied page size
	totalCount		Long	Total number of brands matching the search criteria
	items		Array
		brandId	String	Unique brand identifier (e.g. KR-5)
		brandName	String	Brand name (e.g. NIKE)
		brandLogoUrl	String	Brand logo image URL
		isUIDRequired	Boolean	Whether UID submission is required
		allowedUIDTypes	Array<String>	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"
        ]
      }
    ]
  }
}

Error Spec

HTTP status code (error type)	Error message	How to resolve
400 Bad Request	brandName is required	Include the required brandName parameter
401 Unauthorized	Authentication failed	Verify your HMAC authentication credentials

Brand Search

Summary

Details