Coupang Developer Center

API适用买家市场：韩国

通过品牌名称搜索 Coupang 品牌库。
在商品创建 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 认证信息

品牌搜索

简介

详细内容