ID 기반 브랜드 조회

KRTW

# 01

요약

ID 기반 브랜드 조회

# 02

상세

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

본 API는 brandId를 통해 브랜드의 상세 정보를 조회하는 데 사용됩니다.

경로

GET/v2/providers/seller_api/apis/api/v1/marketplace/brands/{brandId}

예시 엔드포인트

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

# 03

Path 파라미터

Name	Type	Description
brandId*	string	brandId

# 04

응답 본문

응답 메시지

Name	Type	Description
code	string	결과코드 SUCCESS/ERROR
message	string	메시지
data	object
brandId data.brandId	string	고유 브랜드 식별자 (예: KR-5)
brandName data.brandName	string	브랜드명 (예: NIKE)
brandLogoUrl data.brandLogoUrl	string	브랜드 로고 이미지 URL (없으면 null)
isUIDRequired data.isUIDRequired	boolean	해당 브랜드에 UID(GTIN 또는 MPN) 입력이 필수인지 여부
allowedUIDTypes data.allowedUIDTypes	object[]	허용된 UID 유형 목록 (예: ["GTIN", "MPN"])

Response Example

{
  "code": "SUCCESS",
  "message": "",
  "data": {
    "brandId": "KR-5",
    "brandName": "NIKE",
    "brandLogoUrl": "https://image11.coupangcdn.com/image/brand/logo/nike.png",
    "isUIDRequired": true,
    "allowedUIDTypes": [
      "GTIN",
      "MPN"
    ]
  }
}

# 05

에러 코드

HTTP	코드	메시지
400	HTTP_400	Bad Request

오류 사양

HTTP	유형	오류 메시지	해결 방법
400	400 Bad Request	브랜드 조회에 실패했습니다.	유효한 brandId인지 확인하세요.
400	400 Bad Request	brandId 형식이 올바르지 않습니다.	brandId 형식을 확인하세요 (예: KR-5).