> For the complete documentation index, see [llms.txt](https://tech.x2bee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tech.x2bee.com/api/store-front-api/goods-api/undefined-6.md).

# 브랜드

## 브랜드 정보 조회

> \## 기능설명\
> \* 브랜드 정보를 조회합니다.\
> \---\
> \## 상세설명\
> \* 브랜드에 대한 정보를 상세조회합니다.\
> \---\
> \## 검증내용\
> \* 1001 : request값이 없는 경우 발생하는 오류입니다.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE Goods API","version":"v1"},"servers":[{"url":"https://api-goods.x2bee.com/api/goods/","description":"prd"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"BrandRequest":{"type":"object","description":"브랜드 조회관련 조건 DTO","properties":{"langCd":{"type":"string","default":"ko","description":"언어코드(CM009)"},"siteNo":{"type":"string","default":"1","description":"사이트번호 : 1,2,3, ..."},"pageNo":{"type":"integer","format":"int32","description":"호출 페이지 번호"},"pageSize":{"type":"integer","format":"int32","description":"호출 페이지 사이즈"},"dispYn":{"type":"string","default":"Y","description":"전시여부 : Y/N","enum":["Y","N"]},"brandNo":{"type":"array","description":"브랜드 번호 : 123, ...","items":{"type":"string"}},"brandNm":{"type":"string","description":"브랜드명"},"schKwdNm":{"type":"string","description":"검색키워드"},"offset":{"type":"integer","format":"int64"}}},"BrandResponse":{"type":"object","description":"브랜드 검색결과 DTO","properties":{"brandNo":{"type":"string","description":"브랜드번호"},"useYn":{"type":"string","description":"사용여부"},"brandImgPathNm":{"type":"string","description":"브랜드이미지경로명"},"brandImgFileNm":{"type":"string","description":"브랜드이미지파일명"},"langCd":{"type":"string","description":"언어코드(CM009) ko:한국어, en:영어"},"brandNm":{"type":"string","description":"브랜드명"},"brandDescCmt":{"type":"string","description":"브랜드설명내용"},"schKwdNm":{"type":"string","description":"검색키워드명"},"totalCnt":{"type":"integer","format":"int32","description":"갯수"},"productList":{"type":"array","description":"상품리스트","items":{"$ref":"#/components/schemas/BrandProductSummaryResponse"}}}},"BrandProductSummaryResponse":{"type":"object","description":"상품검색 요약정보 검색결과 DTO","properties":{"goodsNo":{"type":"string","description":"상품번호"},"entrNo":{"type":"string","description":"협력사번호"},"goodsCompCd":{"type":"string","description":"상품구성코드(PR001) 10:일반상품, 20:묶음상품"},"goodsTypCd":{"type":"string","description":"상품유형코드(PR002) 10:일반상품, 20:사은품, 30:e-쿠폰상품"},"saleMethCd":{"type":"string","description":"판매방식코드(PR003) 10:일반판매, 20:예약판매"},"brandNo":{"type":"string","description":"브랜드번호"},"buyrAgeLmtCd":{"type":"string","description":"구입자나이제한코드(PR004) 0:, 15:15세이용가, 19:19세이용가, 12:12세이용가"},"dispYn":{"type":"string","description":"전시여부"},"saleStatCd":{"type":"string","description":"판매상태코드(PR005) 01:임시자정, 02:승인대기, 03:반려, 10:판매중, 20:품절, 30:판매종료"},"goodsRegDtm":{"type":"string","format":"date-time","description":"상품등록일시"},"saleStrDtm":{"type":"string","format":"date-time","description":"판매시작일시"},"saleEndDtm":{"type":"string","format":"date-time","description":"판매종료일시"},"stkMgrYn":{"type":"string","description":"재고관리여부"},"deliProcTypCd":{"type":"string","description":"배송처리유형코드(PR008) 10:센터배송, 20:업체배송, 30:e-쿠폰배송"},"deliGoodsGbCd":{"type":"string","description":"배송상품구분코드(PR010) 01:일반상품, 02:설치상품, 03:주문제작, 04:e-쿠폰"},"deliWayCd":{"type":"string","description":"배송수단코드(PR009) 01:택배배송, 02:무배송"},"deliDday":{"type":"string","description":"배송기일"},"deliPolcNo":{"type":"string","description":"배송정책번호"},"prcHistStrDtm":{"type":"string","format":"date-time","description":"가격이력시작일시"},"prcHistEndDtm":{"type":"string","format":"date-time","description":"가격이력종료일시"},"rcntSalePrc":{"type":"string","description":"최근판매가"},"salePrc":{"type":"string","description":"판매가"},"aplyPrc":{"type":"string","description":"적용가"},"dcRate":{"type":"string","description":"할인율"},"dispCtgNo":{"type":"string","description":"전시카테고리번호"},"dlexTypCd":{"type":"string","description":"배송비유형코드(VD005) 10:무료, 20:유료, 30:조건부무료"},"goodsImmedDcCpnNo":{"type":"string","description":"상품즉시할인쿠폰번호"},"goodsImmedDcAplyStrDtm":{"type":"string","format":"date-time","description":"상품즉시할인적용시작일시"},"fixamtFxrtGbCd":{"type":"string","description":"상품즉시정액정율구분코드(MK005)"},"dcRateAmt":{"type":"string","description":"상품즉시할인율금액"},"goodsRepImgContSn":{"type":"string","description":"상품대표이미지컨텐츠일련번호"},"rservSaleYn":{"type":"string","description":"예약판매여부"},"rservStrDtm":{"type":"string","format":"date-time","description":"예약시작일시"},"rservEndDtm":{"type":"string","format":"date-time","description":"예약종료일시"},"goodsRevCnt":{"type":"string","description":"상품리뷰수"},"goodsRevHlpfulCnt":{"type":"string","description":"상품리뷰도움돼요수"},"goodsRevStfdVal":{"type":"string","description":"상품리뷰만족도값"},"wishListCnt":{"type":"string","description":"위시리스트수"},"ordQty":{"type":"string","description":"주문수량"},"langCd":{"type":"string","description":"언어코드(CM009) ko:한국어, en:영어"},"goodsNm":{"type":"string","description":"상품명"},"adveWrd":{"type":"string","description":"홍보문구"},"prestNm":{"type":"string","description":"증정품명"},"brandNm":{"type":"string","description":"브랜드명"},"brandImgPathNm":{"type":"string","description":"브랜드이미지경로명"},"brandImgFileNm":{"type":"string","description":"브랜드이미지파일명"},"goodsRepImgPathNm":{"type":"string","description":"상품 대표이미지"},"trnfTextCont":{"type":"string","description":"상품 대표이미지 대체텍스트"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/brands/list":{"post":{"tags":["브랜드"],"summary":"브랜드 정보 조회","description":"## 기능설명\n* 브랜드 정보를 조회합니다.\n---\n## 상세설명\n* 브랜드에 대한 정보를 상세조회합니다.\n---\n## 검증내용\n* 1001 : request값이 없는 경우 발생하는 오류입니다.\n","operationId":"seltBrandsList","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BrandRequest"}}},"required":true},"responses":{"200":{"description":"브랜드 정보 조회 성공","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/BrandResponse"}}}}},"900":{"description":"브랜드 정보 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```

## 브랜드별 신상품 조회

> \## 기능설명\
> \* 브랜드별 신상품의 정보를 조회합니다.\
> \---\
> \## 상세설명\
> \* 각 브랜드의 최근 상품등록일 순으로 10개의 상품을 조회합니다.\
> \---\
> \## 검증내용\
> \* 1001 : request값이 없거나 request값에 브랜드 번호가 경우 발생하는 오류입니다.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE Goods API","version":"v1"},"servers":[{"url":"https://api-goods.x2bee.com/api/goods/","description":"prd"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"BrandRequest":{"type":"object","description":"브랜드 조회관련 조건 DTO","properties":{"langCd":{"type":"string","default":"ko","description":"언어코드(CM009)"},"siteNo":{"type":"string","default":"1","description":"사이트번호 : 1,2,3, ..."},"pageNo":{"type":"integer","format":"int32","description":"호출 페이지 번호"},"pageSize":{"type":"integer","format":"int32","description":"호출 페이지 사이즈"},"dispYn":{"type":"string","default":"Y","description":"전시여부 : Y/N","enum":["Y","N"]},"brandNo":{"type":"array","description":"브랜드 번호 : 123, ...","items":{"type":"string"}},"brandNm":{"type":"string","description":"브랜드명"},"schKwdNm":{"type":"string","description":"검색키워드"},"offset":{"type":"integer","format":"int64"}}},"ResponseMapStringObject":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"object","additionalProperties":{},"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/brands/brandNewGoodslist":{"post":{"tags":["브랜드"],"summary":"브랜드별 신상품 조회","description":"## 기능설명\n* 브랜드별 신상품의 정보를 조회합니다.\n---\n## 상세설명\n* 각 브랜드의 최근 상품등록일 순으로 10개의 상품을 조회합니다.\n---\n## 검증내용\n* 1001 : request값이 없거나 request값에 브랜드 번호가 경우 발생하는 오류입니다.\n","operationId":"seltBrandNewGoodsList","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BrandRequest"}}},"required":true},"responses":{"200":{"description":"브랜드별 신상품 정보 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseMapStringObject"}}}},"900":{"description":"브랜드별 신상품 정보 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```

## 브랜드별 베스트상품 조회

> \## 기능설명\
> \* 브랜드별 BEST상품의 정보를 조회합니다.\
> \---\
> \## 상세설명\
> \* 각 브랜드의 최근 상품등록일 순으로 10개의 상품을 조회합니다.\
> \---\
> \## 검증내용\
> \* 1001 : request값이 없거나 request값에 브랜드 번호가 경우 발생하는 오류입니다.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE Goods API","version":"v1"},"servers":[{"url":"https://api-goods.x2bee.com/api/goods/","description":"prd"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"BrandRequest":{"type":"object","description":"브랜드 조회관련 조건 DTO","properties":{"langCd":{"type":"string","default":"ko","description":"언어코드(CM009)"},"siteNo":{"type":"string","default":"1","description":"사이트번호 : 1,2,3, ..."},"pageNo":{"type":"integer","format":"int32","description":"호출 페이지 번호"},"pageSize":{"type":"integer","format":"int32","description":"호출 페이지 사이즈"},"dispYn":{"type":"string","default":"Y","description":"전시여부 : Y/N","enum":["Y","N"]},"brandNo":{"type":"array","description":"브랜드 번호 : 123, ...","items":{"type":"string"}},"brandNm":{"type":"string","description":"브랜드명"},"schKwdNm":{"type":"string","description":"검색키워드"},"offset":{"type":"integer","format":"int64"}}},"ResponseMapStringObject":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"object","additionalProperties":{},"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/brands/brandBestGoodslist":{"post":{"tags":["브랜드"],"summary":"브랜드별 베스트상품 조회","description":"## 기능설명\n* 브랜드별 BEST상품의 정보를 조회합니다.\n---\n## 상세설명\n* 각 브랜드의 최근 상품등록일 순으로 10개의 상품을 조회합니다.\n---\n## 검증내용\n* 1001 : request값이 없거나 request값에 브랜드 번호가 경우 발생하는 오류입니다.\n","operationId":"seltBrandBestGoodsList","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BrandRequest"}}},"required":true},"responses":{"200":{"description":"브랜드별 BEST상품 정보 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseMapStringObject"}}}},"900":{"description":"브랜드별 BEST상품 정보 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://tech.x2bee.com/api/store-front-api/goods-api/undefined-6.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.