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 |