API适用买家市场：韩国
通过品牌名称搜索 Coupang 品牌库。
在商品创建 API 中填写 brandId 前，可使用该 API 进行查询。
在商品创建 API 中填写 brandId 前，可使用该 API 进行查询。
路径
POST
/v2/providers/seller_api/apis/api/v1/marketplace/brands/search
示例Endpoint
https://api-gateway.coupang.com/v2/providers/seller_api/apis/api/v1/marketplace/brands/search
请求参数
Body参数
名称 | 必填 | 类型 | 描述 | ||||
|---|---|---|---|---|---|---|---|
| brandName | O | String | 品牌搜索关键词 | ||||
| countPerPage | Integer | 每页结果数（默认：10，最大：10） | |||||
| page | Integer | 页码（默认：1，最小：1） | |||||
请求示例
{
"brandName": "NIKE",
"countPerPage": 10,
"page": 1
}
响应消息
名称 | 类型 | 描述 | ||
|---|---|---|---|---|
| code | String | 结果代码（SUCCESS / ERROR） | ||
| message | String | 结果信息 | ||
| data | Object | |||
| page | Integer | 当前页码 | ||
| countPerPage | Integer | 每页数量 | ||
| totalCount | Long | 符合条件的品牌总数 | ||
| items | Array | 品牌列表 | ||
| brandId | String | 品牌唯一 ID（例：KR-5） | ||
| brandName | String | 品牌名称（例：NIKE） | ||
brandLogoUrl | String | 品牌 Logo 图片 URL | ||
isUIDRequired | Boolean | 是否需要提交 UID | ||
allowedUIDTypes | Array<String> | 允许的 UID 类型列表 (例: GTIN, MPN) | ||
响应示例
{
"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"
]
}
]
}
}
错误说明
HTTP 状态码 | 错误信息 | 解决方法 |
|---|---|---|
| 400 Bad Request | brandName is required | 请填写必填参数 brandName |
| 401 Unauthorized | Authentication failed | 请检查 HMAC 认证信息 |