Coupang Developer Center

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

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

Path

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}

요청 파라미터

Body 파라미터

파라미터명	필수 여부	타입	설명
brandId	O	String	고유 브랜드 식별자 (예: KR-5)

요청 예시

없음

응답 메시지

파라미터명		타입	설명
code		String	결과코드 SUCCESS/ERROR
message		String	메시지
data		Object
	brandId	String	고유 브랜드 식별자 (예: KR-5)
	brandName	String	브랜드명 (예: NIKE)
	brandLogoUrl	String	브랜드 로고 이미지 URL (없으면 null)
	isUIDRequired	Boolean	해당 브랜드에 UID(GTIN 또는 MPN) 입력이 필수인지 여부
	allowedUIDTypes	Array[String]	허용된 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"]
  }
}

Error Spec

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

ID 기반 브랜드 조회

요약

상세