브랜드 검색

KRTW

# 01

요약

브랜드 검색

# 02

상세

사용 가능 구매자 마켓: 한국

쿠팡 브랜드 라이브러리에서 브랜드명을 기준으로 검색합니다.
상품 생성 API에서 brandId를 입력하기 전에 해당 값을 조회할 때 사용합니다.

경로

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	브랜드 로고 이미지 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 인증 정보를 확인하세요