사용 가능 구매자 마켓: 한국
쿠팡 브랜드 라이브러리에서 브랜드명을 기준으로 검색합니다.
상품 생성 API에서 brandId를 입력하기 전에 해당 값을 조회할 때 사용합니다.
경로
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파라미터
| Name | Required | Type | Description | ||||
|---|---|---|---|---|---|---|---|
| brandName | O | String | 브랜드 검색 키워드 | ||||
| countPerPage | Integer | 페이지당 결과 수 (기본값: 10, 최대: 10) | |||||
| page | Integer | 페이지 번호 (기본값: 1, 최소: 1) | |||||
요청 예시
{
"brandName": "NIKE",
"countPerPage": 10,
"page": 1
}
응답 메시지
| Name | Type | Description | ||
|---|---|---|---|---|
| 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 | 브랜드 로고 이미지 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 인증 정보를 확인하세요 |