品牌搜索

# 01

简介

品牌搜索

# 02

详细内容

API适用买家市场：韩国

通过品牌名称搜索 Coupang 品牌库。
在商品创建 API 中填写 brandId 前，可使用该 API 进行查询。

路径

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

示例端点

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

# 03

请求体参数

请求参数

请求体参数

Name	Type	Description
brandName*	string	品牌搜索关键词
countPerPage	integer	每页结果数（默认：10，最大：10）
page	integer	页码（默认：1，最小：1）

请求示例application/json

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

# 04

响应体

响应消息

Name	Type	Description
code	string	结果代码（SUCCESS / ERROR）
message	string	结果信息
data	object
page data.page	integer	当前页码
countPerPage data.countPerPage	integer	每页数量
totalCount data.totalCount	integer	符合条件的品牌总数
items data.items	object[]	品牌列表
brandId data.items[].brandId	string	品牌唯一 ID（例：KR-5）
brandName data.items[].brandName	string	品牌名称（例：NIKE）
brandLogoUrl data.items[].brandLogoUrl	string	品牌 Logo 图片 URL
isUIDRequired data.items[].isUIDRequired	boolean	是否需要提交 UID
allowedUIDTypes data.items[].allowedUIDTypes	object[]	允许的 UID 类型列表 (例: 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

错误码

HTTP	代码	消息
400	HTTP_400	Bad Request

错误说明

HTTP	类型	错误消息	解决方案
400	400 Bad Request	brandName is required	请填写必填参数 brandName
401	401 Unauthorized	Authentication failed	请检查 HMAC 认证信息