> 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-3.md).
# 상품검색
## 상품 통합 검색
> \## 기능설명\
> \* 상품에 대한 통합 검색 결과를 보여줍니다.\
> \---\
> \## 상세설명\
> \* 검색 페이지에서 키워드 검색을 진행할 때 호출합니다.\
> \* 검색어에 대한 상품의 통합 정보를 보여줍니다.\
> \* 통합 검색 결과는 상품 목록, 카테고리 목록, 브랜드 목록, 연관검색어 목록입니다.\
> \---\
> \## 수정번호\
> \* Release v1.04\_231120 : 검색페이지 통합 검색, 검색페이지 통합 검색 신규 추가
```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":{"SearchRequest":{"type":"object","description":"검색기본 Request","properties":{"searchWord":{"type":"string","description":"검색어"},"langCd":{"type":"string","description":"다국어코드"},"siteNo":{"type":"string","description":"사이트번호"},"sort":{"type":"string","description":"정렬구분코드"},"sortField":{"type":"string","description":"정렬대상항목"},"size":{"type":"string","description":"페이지당 노출수"},"from":{"type":"string","description":"페이지 시작점"},"filters":{"type":"string","description":"필터값"},"filter":{"type":"string","description":"필터값"},"minPrc":{"type":"integer","format":"int32","description":"최소가격"},"maxPrc":{"type":"integer","format":"int32","description":"최대가격"},"ctgNo":{"type":"string","description":"카테고리매장번호"},"vector":{"type":"array","description":"벡터 데이터","items":{"type":"string"}},"special":{"type":"string","description":"스페셜검색"}}},"SearchProductResponse":{"type":"object","description":"검색엔진 검색결과 DTO","properties":{"size":{"type":"string","description":"페이지당 노출수"},"from":{"type":"string","description":"페이지 시작점"},"totalCount":{"type":"integer","format":"int32","description":"총건수"},"searchDataList":{"type":"array","description":"상품 목록","items":{"$ref":"#/components/schemas/ProductSummaryResponse"}},"categoryDataList":{"type":"array","description":"카테고리 목록","items":{"$ref":"#/components/schemas/SearchProductCateData"}},"assocwordDataList":{"type":"array","description":"연관검색어 목록","items":{"type":"string"}},"brandDataList":{"type":"array","description":"브랜드 목록","items":{"$ref":"#/components/schemas/SearchProductBrandInfo"}},"lrgCtgGrpData":{"type":"array","description":"대카테고리정보","items":{"$ref":"#/components/schemas/SearchLargeCategoryData"}},"minPrc":{"type":"integer","format":"int32","description":"최소가격정보"},"maxPrc":{"type":"integer","format":"int32","description":"최대가격정보"}}},"ProductSummaryResponse":{"type":"object","description":"상품검색 요약정보 검색결과 DTO","properties":{"id":{"type":"string","description":"상품ID"},"goodsNo":{"type":"string","description":"상품번호"},"goodsNm":{"type":"string","description":"상품명"},"prestNm":{"type":"string","description":"증정품명"},"adveWrd":{"type":"string","description":"홍보문구"},"schKwdNm":{"type":"array","description":"검색키워드명","items":{"type":"string"}},"brandNo":{"type":"string","description":"브랜드번호"},"brandNm":{"type":"string","description":"브랜드명"},"buyrAgeLmtCd":{"type":"string","description":"구입자연령제한코드"},"goodsRegDtm":{"type":"string","format":"date-time","description":"상품등록일시"},"saleStatCd":{"type":"string","description":"판매상태코드"},"deliProcTypCd":{"type":"string","description":"배송처리유형코드"},"deliWayCd":{"type":"string","description":"배송수단코드"},"deliDday":{"type":"string","description":"배송기일"},"rcntSalePrc":{"type":"string","description":"최근판매가격"},"salePrc":{"type":"number","description":"판매가"},"aplyPrc":{"type":"number","description":"적용가"},"dcRate":{"type":"integer","format":"int32","description":"할인율"},"dispCtgNo":{"type":"array","description":"전시카테고리번호","items":{"$ref":"#/components/schemas/SearchProductCateData"}},"dlexTypCd":{"type":"string","description":"배송비유형코드"},"payWayMeanCd":{"type":"string","description":"결제수단코드정보"},"rservSaleYn":{"type":"string","description":"예약판매여부"},"goodsRevCnt":{"type":"integer","format":"int32","description":"상품리뷰건수"},"goodsRevHlpfulCnt":{"type":"integer","format":"int32","description":"상품리뷰도움돼요건수"},"goodsRevStarscrAvgVal":{"type":"integer","format":"int32","description":"상품리뷰별점평균값"},"wishListCnt":{"type":"string","description":"위시리스트수"},"goodsDtlDesc":{"type":"string","description":"상품상세설명"},"sendGb":{"type":"string","description":"전송구분"},"langCd":{"type":"string","description":"언어코드"},"extraData":{"type":"string","description":"ExtraData"},"goodsRepImgPathNm":{"type":"string","description":"상품 대표이미지"},"trnfTextCont":{"type":"string","description":"상품 대표이미지 대체텍스트"},"iconJson":{"type":"string","description":"ICON 정보"},"colorDataList":{"$ref":"#/components/schemas/SearchProductColorData","description":"색상 리스트"},"iconList":{"type":"array","items":{"type":"string"}}}},"SearchProductCateData":{"type":"object","description":"상품검색 요약정보 검색결과 카테고리정보","properties":{"dispCtgNo":{"type":"string","description":"전시카테고리번호"},"ctgFullPath":{"type":"string","description":"카테고리전체경로"},"ctgFullPathNm":{"type":"string","description":"카테고리전체경로명"},"siteNo":{"type":"string","description":"사이트번호"},"siteNm":{"type":"string","description":"사이트명"},"dpmlNo":{"type":"string","description":"몰번호"},"lrgCtgNm":{"type":"string","description":"대카테고리명"},"lrgCtgNo":{"type":"string","description":"대카테고리번호"}}},"SearchProductColorData":{"type":"object","properties":{"colorName":{"type":"string"},"subImageUrl":{"type":"string"},"score":{"type":"string"}}},"SearchProductBrandInfo":{"type":"object","properties":{"brandNo":{"type":"string"},"brandNm":{"type":"string"}}},"SearchLargeCategoryData":{"type":"object","properties":{"lrgCtgNm":{"type":"string","description":"대카테고리명"},"lrgCtgNo":{"type":"string","description":"대카테고리번호"},"count":{"type":"integer","format":"int32","description":"대카테고리그룹핑카운트"},"subCtgGrpData":{"type":"array","description":"중카테고리정보","items":{"$ref":"#/components/schemas/SearchSubCategoryData"}}}},"SearchSubCategoryData":{"type":"object","properties":{"subCtgNm":{"type":"string","description":"하위카테고리명"},"subCtgNo":{"type":"string","description":"하위카테고리번호"},"count":{"type":"integer","format":"int32","description":"하위카테고리그룹핑카운트"},"subCtgGrpData":{"description":"하위카테고리정보"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/search/search":{"post":{"tags":["상품검색"],"summary":"상품 통합 검색","description":"## 기능설명\n* 상품에 대한 통합 검색 결과를 보여줍니다.\n---\n## 상세설명\n* 검색 페이지에서 키워드 검색을 진행할 때 호출합니다.\n* 검색어에 대한 상품의 통합 정보를 보여줍니다.\n* 통합 검색 결과는 상품 목록, 카테고리 목록, 브랜드 목록, 연관검색어 목록입니다.\n---\n## 수정번호\n* Release v1.04_231120 : 검색페이지 통합 검색, 검색페이지 통합 검색 신규 추가\n","operationId":"seltSearchEngine","parameters":[{"name":"searchWord","in":"query","description":"검색키워드","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchRequest"}}},"required":true},"responses":{"200":{"description":"상품 통합 검색 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/SearchProductResponse"}}}},"900":{"description":"상품 통합 검색 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```
## POST /v1/search/product-image
>
```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":{"SearchRequest":{"type":"object","description":"검색기본 Request","properties":{"searchWord":{"type":"string","description":"검색어"},"langCd":{"type":"string","description":"다국어코드"},"siteNo":{"type":"string","description":"사이트번호"},"sort":{"type":"string","description":"정렬구분코드"},"sortField":{"type":"string","description":"정렬대상항목"},"size":{"type":"string","description":"페이지당 노출수"},"from":{"type":"string","description":"페이지 시작점"},"filters":{"type":"string","description":"필터값"},"filter":{"type":"string","description":"필터값"},"minPrc":{"type":"integer","format":"int32","description":"최소가격"},"maxPrc":{"type":"integer","format":"int32","description":"최대가격"},"ctgNo":{"type":"string","description":"카테고리매장번호"},"vector":{"type":"array","description":"벡터 데이터","items":{"type":"string"}},"special":{"type":"string","description":"스페셜검색"}}},"SearchProductResponse":{"type":"object","description":"검색엔진 검색결과 DTO","properties":{"size":{"type":"string","description":"페이지당 노출수"},"from":{"type":"string","description":"페이지 시작점"},"totalCount":{"type":"integer","format":"int32","description":"총건수"},"searchDataList":{"type":"array","description":"상품 목록","items":{"$ref":"#/components/schemas/ProductSummaryResponse"}},"categoryDataList":{"type":"array","description":"카테고리 목록","items":{"$ref":"#/components/schemas/SearchProductCateData"}},"assocwordDataList":{"type":"array","description":"연관검색어 목록","items":{"type":"string"}},"brandDataList":{"type":"array","description":"브랜드 목록","items":{"$ref":"#/components/schemas/SearchProductBrandInfo"}},"lrgCtgGrpData":{"type":"array","description":"대카테고리정보","items":{"$ref":"#/components/schemas/SearchLargeCategoryData"}},"minPrc":{"type":"integer","format":"int32","description":"최소가격정보"},"maxPrc":{"type":"integer","format":"int32","description":"최대가격정보"}}},"ProductSummaryResponse":{"type":"object","description":"상품검색 요약정보 검색결과 DTO","properties":{"id":{"type":"string","description":"상품ID"},"goodsNo":{"type":"string","description":"상품번호"},"goodsNm":{"type":"string","description":"상품명"},"prestNm":{"type":"string","description":"증정품명"},"adveWrd":{"type":"string","description":"홍보문구"},"schKwdNm":{"type":"array","description":"검색키워드명","items":{"type":"string"}},"brandNo":{"type":"string","description":"브랜드번호"},"brandNm":{"type":"string","description":"브랜드명"},"buyrAgeLmtCd":{"type":"string","description":"구입자연령제한코드"},"goodsRegDtm":{"type":"string","format":"date-time","description":"상품등록일시"},"saleStatCd":{"type":"string","description":"판매상태코드"},"deliProcTypCd":{"type":"string","description":"배송처리유형코드"},"deliWayCd":{"type":"string","description":"배송수단코드"},"deliDday":{"type":"string","description":"배송기일"},"rcntSalePrc":{"type":"string","description":"최근판매가격"},"salePrc":{"type":"number","description":"판매가"},"aplyPrc":{"type":"number","description":"적용가"},"dcRate":{"type":"integer","format":"int32","description":"할인율"},"dispCtgNo":{"type":"array","description":"전시카테고리번호","items":{"$ref":"#/components/schemas/SearchProductCateData"}},"dlexTypCd":{"type":"string","description":"배송비유형코드"},"payWayMeanCd":{"type":"string","description":"결제수단코드정보"},"rservSaleYn":{"type":"string","description":"예약판매여부"},"goodsRevCnt":{"type":"integer","format":"int32","description":"상품리뷰건수"},"goodsRevHlpfulCnt":{"type":"integer","format":"int32","description":"상품리뷰도움돼요건수"},"goodsRevStarscrAvgVal":{"type":"integer","format":"int32","description":"상품리뷰별점평균값"},"wishListCnt":{"type":"string","description":"위시리스트수"},"goodsDtlDesc":{"type":"string","description":"상품상세설명"},"sendGb":{"type":"string","description":"전송구분"},"langCd":{"type":"string","description":"언어코드"},"extraData":{"type":"string","description":"ExtraData"},"goodsRepImgPathNm":{"type":"string","description":"상품 대표이미지"},"trnfTextCont":{"type":"string","description":"상품 대표이미지 대체텍스트"},"iconJson":{"type":"string","description":"ICON 정보"},"colorDataList":{"$ref":"#/components/schemas/SearchProductColorData","description":"색상 리스트"},"iconList":{"type":"array","items":{"type":"string"}}}},"SearchProductCateData":{"type":"object","description":"상품검색 요약정보 검색결과 카테고리정보","properties":{"dispCtgNo":{"type":"string","description":"전시카테고리번호"},"ctgFullPath":{"type":"string","description":"카테고리전체경로"},"ctgFullPathNm":{"type":"string","description":"카테고리전체경로명"},"siteNo":{"type":"string","description":"사이트번호"},"siteNm":{"type":"string","description":"사이트명"},"dpmlNo":{"type":"string","description":"몰번호"},"lrgCtgNm":{"type":"string","description":"대카테고리명"},"lrgCtgNo":{"type":"string","description":"대카테고리번호"}}},"SearchProductColorData":{"type":"object","properties":{"colorName":{"type":"string"},"subImageUrl":{"type":"string"},"score":{"type":"string"}}},"SearchProductBrandInfo":{"type":"object","properties":{"brandNo":{"type":"string"},"brandNm":{"type":"string"}}},"SearchLargeCategoryData":{"type":"object","properties":{"lrgCtgNm":{"type":"string","description":"대카테고리명"},"lrgCtgNo":{"type":"string","description":"대카테고리번호"},"count":{"type":"integer","format":"int32","description":"대카테고리그룹핑카운트"},"subCtgGrpData":{"type":"array","description":"중카테고리정보","items":{"$ref":"#/components/schemas/SearchSubCategoryData"}}}},"SearchSubCategoryData":{"type":"object","properties":{"subCtgNm":{"type":"string","description":"하위카테고리명"},"subCtgNo":{"type":"string","description":"하위카테고리번호"},"count":{"type":"integer","format":"int32","description":"하위카테고리그룹핑카운트"},"subCtgGrpData":{"description":"하위카테고리정보"}}}}},"paths":{"/v1/search/product-image":{"post":{"tags":["상품검색"],"operationId":"seltSearchProductImage","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/SearchProductResponse"}}}}}}}}}
```
## 기획전 검색
> \## 기능설명\
> \* 검색어와 관련된 기획전 정보를 검색합니다.\
> \---\
> \## 상세설명\
> \* 검색어를 입력하면 연관된 기획전 정보를 제공합니다.\
> \* 기획전 검색은 다국어를 지원하며 파라미터로 다국어 코드(langCd: ko, en 등)가 필수입니다.\
> \* 필요한 정보는 extraData 필드에 추가하여 사용할 수 있습니다.\
> \* 검색어, 카테고리, 필터 등의 값을 받아 해당 조건에 맞는 기획전을 검색합니다.\
> \---\
> \## 수정번호\
> \* Release v1.04\_231120 : 검색페이지 기획전 검색 추가, 검색페이지 기획전 검색 신규 추가
```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":{"SearchRequest":{"type":"object","description":"검색기본 Request","properties":{"searchWord":{"type":"string","description":"검색어"},"langCd":{"type":"string","description":"다국어코드"},"siteNo":{"type":"string","description":"사이트번호"},"sort":{"type":"string","description":"정렬구분코드"},"sortField":{"type":"string","description":"정렬대상항목"},"size":{"type":"string","description":"페이지당 노출수"},"from":{"type":"string","description":"페이지 시작점"},"filters":{"type":"string","description":"필터값"},"filter":{"type":"string","description":"필터값"},"minPrc":{"type":"integer","format":"int32","description":"최소가격"},"maxPrc":{"type":"integer","format":"int32","description":"최대가격"},"ctgNo":{"type":"string","description":"카테고리매장번호"},"vector":{"type":"array","description":"벡터 데이터","items":{"type":"string"}},"special":{"type":"string","description":"스페셜검색"}}},"SearchExhibitionInfo":{"type":"object","properties":{"id":{"type":"string","description":"기획전번호"},"mkdpNo":{"type":"string","description":"기획전번호"},"title":{"type":"string","description":"기획전명"},"description":{"type":"string","description":"기획전설명"},"schKwdNm":{"type":"string","description":"키워드명"},"brandCodes":{"type":"string","description":"브랜드번호들"},"brandImgPathNm":{"type":"string","description":"배너이미지경로명"},"altCont":{"type":"string","description":"배너이미지 대체텍스트"},"dispStrDtm":{"type":"string","format":"date-time","description":"기획전시작일시"},"dispEndDtm":{"type":"string","format":"date-time","description":"기획전종료일시"},"extraData":{"type":"string","description":"추가데이터"},"langCd":{"type":"string","description":"언어코드"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/search/marketing":{"post":{"tags":["상품검색"],"summary":"기획전 검색","description":"## 기능설명\n* 검색어와 관련된 기획전 정보를 검색합니다.\n---\n## 상세설명\n* 검색어를 입력하면 연관된 기획전 정보를 제공합니다.\n* 기획전 검색은 다국어를 지원하며 파라미터로 다국어 코드(langCd: ko, en 등)가 필수입니다.\n* 필요한 정보는 extraData 필드에 추가하여 사용할 수 있습니다.\n* 검색어, 카테고리, 필터 등의 값을 받아 해당 조건에 맞는 기획전을 검색합니다.\n---\n## 수정번호\n* Release v1.04_231120 : 검색페이지 기획전 검색 추가, 검색페이지 기획전 검색 신규 추가\n","operationId":"seltExhibiionList","parameters":[{"name":"searchWord","in":"query","description":"검색키워드","required":true,"schema":{"type":"string"}},{"name":"langCd","in":"query","description":"다국어 코드","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchRequest"}}},"required":true},"responses":{"200":{"description":"기획전 검색 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/SearchExhibitionInfo"}}}},"900":{"description":"기획전 검색 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```
## 이벤트 검색
> \## 기능설명\
> \* 검색어와 관련된 이벤트 정보를 검색합니다.\
> \---\
> \## 상세설명\
> \* 검색어를 입력하면 연관된 이벤트 정보를 제공합니다.\
> \* 필요한 정보는 extraData 필드에 추가하여 사용할 수 있습니다.\
> \* 검색어, 카테고리, 필터 등의 값을 받아 해당 조건에 맞는 이벤트를 검색합니다.\
> \---\
> \## 수정번호\
> \* Release v1.04\_231120 : 검색페이지 이벤트 검색 추가, 검색페이지 이벤트 검색 신규 추가
```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":{"SearchRequest":{"type":"object","description":"검색기본 Request","properties":{"searchWord":{"type":"string","description":"검색어"},"langCd":{"type":"string","description":"다국어코드"},"siteNo":{"type":"string","description":"사이트번호"},"sort":{"type":"string","description":"정렬구분코드"},"sortField":{"type":"string","description":"정렬대상항목"},"size":{"type":"string","description":"페이지당 노출수"},"from":{"type":"string","description":"페이지 시작점"},"filters":{"type":"string","description":"필터값"},"filter":{"type":"string","description":"필터값"},"minPrc":{"type":"integer","format":"int32","description":"최소가격"},"maxPrc":{"type":"integer","format":"int32","description":"최대가격"},"ctgNo":{"type":"string","description":"카테고리매장번호"},"vector":{"type":"array","description":"벡터 데이터","items":{"type":"string"}},"special":{"type":"string","description":"스페셜검색"}}},"SearchEventInfo":{"type":"object","properties":{"id":{"type":"string","description":"이벤트번호"},"evtNo":{"type":"string","description":"이벤트번호"},"title":{"type":"string","description":"이벤트명"},"description":{"type":"string","description":"홍보문구내용"},"schKwdNm":{"type":"string","description":"이벤트검색태그"},"sendGb":{"type":"string","description":"전송구분코드"},"extraData":{"type":"string","description":"추가데이터"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/search/event":{"post":{"tags":["상품검색"],"summary":"이벤트 검색","description":"## 기능설명\n* 검색어와 관련된 이벤트 정보를 검색합니다.\n---\n## 상세설명\n* 검색어를 입력하면 연관된 이벤트 정보를 제공합니다.\n* 필요한 정보는 extraData 필드에 추가하여 사용할 수 있습니다.\n* 검색어, 카테고리, 필터 등의 값을 받아 해당 조건에 맞는 이벤트를 검색합니다.\n---\n## 수정번호\n* Release v1.04_231120 : 검색페이지 이벤트 검색 추가, 검색페이지 이벤트 검색 신규 추가\n","operationId":"seltEventList","parameters":[{"name":"searchWord","in":"query","description":"검색키워드","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchRequest"}}},"required":true},"responses":{"200":{"description":"이벤트 검색 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/SearchEventInfo"}}}},"900":{"description":"이벤트 검색 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```
## GET /v1/search/searchRecommendWord
>
```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":{"SearchResultResponseSearchRecommendWord":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32","description":"총건수"},"searchDataList":{"type":"array","description":"검색결과 리스트","items":{"$ref":"#/components/schemas/SearchRecommendWord"}}}},"SearchRecommendWord":{"type":"object","properties":{"recommWord":{"type":"string"},"schWord":{"type":"string"},"siteLink":{"type":"string"},"recommType":{"type":"string"}}}}},"paths":{"/v1/search/searchRecommendWord":{"get":{"tags":["상품검색"],"operationId":"seltSearchRecommendWord","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/SearchResultResponseSearchRecommendWord"}}}}}}}}}
```
## GET /v1/search/searchMarkupWord
>
```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":{"SearchResultResponseSearchRecommendWord":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32","description":"총건수"},"searchDataList":{"type":"array","description":"검색결과 리스트","items":{"$ref":"#/components/schemas/SearchRecommendWord"}}}},"SearchRecommendWord":{"type":"object","properties":{"recommWord":{"type":"string"},"schWord":{"type":"string"},"siteLink":{"type":"string"},"recommType":{"type":"string"}}}}},"paths":{"/v1/search/searchMarkupWord":{"get":{"tags":["상품검색"],"operationId":"seltSearchMarkupWord","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/SearchResultResponseSearchRecommendWord"}}}}}}}}}
```
## 검색 기본문구 조회
> \## 기능설명\
> \* 검색기본문구를 조회하는 API입니다.\
> \---\
> \## 상세설명\
> \* 쿠키에 저장된 언어코드를 사용하여 조회합니다.\
> \* 추천검색어 중에 적용기간이 해당되며, 사용여부가 'Y'인 추천검색어를 조회합니다.
```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":{"PrSchBaseWrdInfo":{"type":"object","description":"검색기본문구 DTO","properties":{"langCd":{"type":"string","description":"언어코드(CM009)"},"baseSchWrdWrd":{"type":"string","description":"기본검색어문구"},"schWrd":{"type":"string","description":"검색어"},"schBaseWrdSeq":{"type":"string","description":"검색기본문구순번"},"aplyStrDtm":{"type":"string","format":"date-time","description":"적용시작일시"},"aplyEndDtm":{"type":"string","format":"date-time","description":"적용종료일시"},"linkUrlAddr":{"type":"string","description":"연결URL주소"},"useYn":{"type":"string","description":"사용여부"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/search/schBaseWrdList":{"get":{"tags":["상품검색"],"summary":"검색 기본문구 조회","description":"## 기능설명\n* 검색기본문구를 조회하는 API입니다.\n---\n## 상세설명\n* 쿠키에 저장된 언어코드를 사용하여 조회합니다.\n* 추천검색어 중에 적용기간이 해당되며, 사용여부가 'Y'인 추천검색어를 조회합니다.\n","operationId":"seltSchBaseWrdList","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"검색기본문구 조회 성공","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/PrSchBaseWrdInfo"}}}}},"900":{"description":"검색기본문구 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```
## 추천 검색어
> \## 기능설명\
> \* 입력한 검색어에 대한 추천 검색어를 반환합니다.\
> \---\
> \## 상세설명\
> \* 검색어를 입력하면 연관된 추천 검색어를 보여줄 때 사용합니다.\
> \* 키워드 입력시 실시간으로 연동하면 자동완성과 동일한 기능으로 구현이 가능합니다.\
> \* 최종 responses는 list 노드에 array 형태로 보내준다. ( {list:\[{responses}]} )\
> \---\
> \## 수정번호\
> \* Release v1.04\_231120 : 검색페이지 자동완성단어 추가, 검색페이지 자동완성단어 신규 추가\
> \* \`\`\`Release v2.00\_240627\`\`\` : 자동완성단어 대상을 상품, 기획전, 이벤트, 카테고리, 브랜드로 확장
````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":{"SearchRecommKeywords":{"type":"object","properties":{"category":{"type":"string","description":"추천 항목"},"item":{"$ref":"#/components/schemas/SearchBrandCateInfo","description":"추천 검색어"}}},"SearchBrandCateInfo":{"type":"object","properties":{"title":{"type":"string"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/search/recommendation":{"get":{"tags":["상품검색"],"summary":"추천 검색어","description":"## 기능설명\n* 입력한 검색어에 대한 추천 검색어를 반환합니다.\n---\n## 상세설명\n* 검색어를 입력하면 연관된 추천 검색어를 보여줄 때 사용합니다.\n* 키워드 입력시 실시간으로 연동하면 자동완성과 동일한 기능으로 구현이 가능합니다.\n* 최종 responses는 list 노드에 array 형태로 보내준다. ( {list:[{responses}]} )\n---\n## 수정번호\n* Release v1.04_231120 : 검색페이지 자동완성단어 추가, 검색페이지 자동완성단어 신규 추가\n* ```Release v2.00_240627``` : 자동완성단어 대상을 상품, 기획전, 이벤트, 카테고리, 브랜드로 확장\n","operationId":"seltRecommendationList","parameters":[{"name":"searchWord","in":"query","description":"검색키워드","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"추천검색어 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/SearchRecommKeywords"}}}},"900":{"description":"추천검색어 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
````
## 검색창 마크업 및 추천검색어
> \## 기능설명\
> \* BO 에서 등록한 검색창 마크업 및 추천 검색어 단어 정보를 제공합니다.\
> \---\
> \## 상세설명\
> \* BO 연관 메뉴 : 상품 > 검색어관리 > 추천검색어, BO 상품 > 검색어관리 > 마크업 검색어\
> \* 추천검색어, 마크업 검색어 중에서 가장 최근에 수정된 내용을 제공합니다.\
> \* 제공된 내용은 검색 페이지 진입 시 검색창에 기본으로 노출하여 의도하는 상품이나 기획 페이지로의 유인에 사용할 수 있습니다.\
> \---\
> \## 수정번호\
> \* Release v1.04\_231120 : 검색창 마크업 및 추천검색어 추가, 검색창 마크업 및 추천검색어 신규 추가
```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":{"SearchRecommendWord":{"type":"object","properties":{"recommWord":{"type":"string"},"schWord":{"type":"string"},"siteLink":{"type":"string"},"recommType":{"type":"string"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/search/recommendWord":{"get":{"tags":["상품검색"],"summary":"검색창 마크업 및 추천검색어","description":"## 기능설명\n* BO 에서 등록한 검색창 마크업 및 추천 검색어 단어 정보를 제공합니다.\n---\n## 상세설명\n* BO 연관 메뉴 : 상품 > 검색어관리 > 추천검색어, BO 상품 > 검색어관리 > 마크업 검색어\n* 추천검색어, 마크업 검색어 중에서 가장 최근에 수정된 내용을 제공합니다.\n* 제공된 내용은 검색 페이지 진입 시 검색창에 기본으로 노출하여 의도하는 상품이나 기획 페이지로의 유인에 사용할 수 있습니다.\n---\n## 수정번호\n* Release v1.04_231120 : 검색창 마크업 및 추천검색어 추가, 검색창 마크업 및 추천검색어 신규 추가\n","operationId":"seltRecommendWord","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"이벤트 검색 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/SearchRecommendWord"}}}},"900":{"description":"이벤트 검색 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```
## 추천 검색어 조회
> \## 기능설명\
> \* 추천검색어를 조회하는 API입니다.\
> \---\
> \## 상세설명\
> \* 쿠키에 저장된 언어코드를 사용하여 조회합니다.\
> \* 추천검색어 중에 적용기간이 해당되며, 사용여부가 'Y'인 추천검색어를 조회합니다.
```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":{"PrRecomSchWrdInfo":{"type":"object","description":"추천검색어 DTO","properties":{"langCd":{"type":"string","description":"언어코드(CM009)"},"recomSchWrd":{"type":"string","description":"추천검색어"},"recomSchWrdSeq":{"type":"string","description":"추천검색어순번"},"aplyStrDtm":{"type":"string","format":"date-time","description":"적용시작일시"},"aplyEndDtm":{"type":"string","format":"date-time","description":"적용종료일시"},"sortSeq":{"type":"string","description":"정렬순서"},"useYn":{"type":"string","description":"사용여부"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/search/recomSchWrdList":{"get":{"tags":["상품검색"],"summary":"추천 검색어 조회","description":"## 기능설명\n* 추천검색어를 조회하는 API입니다.\n---\n## 상세설명\n* 쿠키에 저장된 언어코드를 사용하여 조회합니다.\n* 추천검색어 중에 적용기간이 해당되며, 사용여부가 'Y'인 추천검색어를 조회합니다.\n","operationId":"seltRecomSchWrdList","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"추천검색어 조회 성공","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/PrRecomSchWrdInfo"}}}}},"900":{"description":"추천검색어 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```
## 상품 조건 검색
> \## 기능설명\
> \* 검색어에 조건을 추가하여 상품 목록을 검색한다.\
> \---\
> \## 상세설명\
> \* 검색 페이지의 정렬 조건, 필터 조건등을 추가하여 상품 목록을 검색할 수 있다.\
> \* 정렬 조건은 코드가 약속되어 있다. (10:판매순, 20:낮은가격순, 30:높은가격순, 40:할인율순, 50:최신순, 60:상품평많은순)\
> \* 필터 조건은 다양하게 추가가 가능하며 Search Swagger의 /goods를 참고하여 필요한 조건을 추가하여 사용한다.\
> \---\
> \## 수정번호\
> \* Release v1.04\_231120 : 상품 조건 검색 추가, 상품 조건 검색 신규 추가
```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":{"SearchRequest":{"type":"object","description":"검색기본 Request","properties":{"searchWord":{"type":"string","description":"검색어"},"langCd":{"type":"string","description":"다국어코드"},"siteNo":{"type":"string","description":"사이트번호"},"sort":{"type":"string","description":"정렬구분코드"},"sortField":{"type":"string","description":"정렬대상항목"},"size":{"type":"string","description":"페이지당 노출수"},"from":{"type":"string","description":"페이지 시작점"},"filters":{"type":"string","description":"필터값"},"filter":{"type":"string","description":"필터값"},"minPrc":{"type":"integer","format":"int32","description":"최소가격"},"maxPrc":{"type":"integer","format":"int32","description":"최대가격"},"ctgNo":{"type":"string","description":"카테고리매장번호"},"vector":{"type":"array","description":"벡터 데이터","items":{"type":"string"}},"special":{"type":"string","description":"스페셜검색"}}},"SearchProductResponse":{"type":"object","description":"검색엔진 검색결과 DTO","properties":{"size":{"type":"string","description":"페이지당 노출수"},"from":{"type":"string","description":"페이지 시작점"},"totalCount":{"type":"integer","format":"int32","description":"총건수"},"searchDataList":{"type":"array","description":"상품 목록","items":{"$ref":"#/components/schemas/ProductSummaryResponse"}},"categoryDataList":{"type":"array","description":"카테고리 목록","items":{"$ref":"#/components/schemas/SearchProductCateData"}},"assocwordDataList":{"type":"array","description":"연관검색어 목록","items":{"type":"string"}},"brandDataList":{"type":"array","description":"브랜드 목록","items":{"$ref":"#/components/schemas/SearchProductBrandInfo"}},"lrgCtgGrpData":{"type":"array","description":"대카테고리정보","items":{"$ref":"#/components/schemas/SearchLargeCategoryData"}},"minPrc":{"type":"integer","format":"int32","description":"최소가격정보"},"maxPrc":{"type":"integer","format":"int32","description":"최대가격정보"}}},"ProductSummaryResponse":{"type":"object","description":"상품검색 요약정보 검색결과 DTO","properties":{"id":{"type":"string","description":"상품ID"},"goodsNo":{"type":"string","description":"상품번호"},"goodsNm":{"type":"string","description":"상품명"},"prestNm":{"type":"string","description":"증정품명"},"adveWrd":{"type":"string","description":"홍보문구"},"schKwdNm":{"type":"array","description":"검색키워드명","items":{"type":"string"}},"brandNo":{"type":"string","description":"브랜드번호"},"brandNm":{"type":"string","description":"브랜드명"},"buyrAgeLmtCd":{"type":"string","description":"구입자연령제한코드"},"goodsRegDtm":{"type":"string","format":"date-time","description":"상품등록일시"},"saleStatCd":{"type":"string","description":"판매상태코드"},"deliProcTypCd":{"type":"string","description":"배송처리유형코드"},"deliWayCd":{"type":"string","description":"배송수단코드"},"deliDday":{"type":"string","description":"배송기일"},"rcntSalePrc":{"type":"string","description":"최근판매가격"},"salePrc":{"type":"number","description":"판매가"},"aplyPrc":{"type":"number","description":"적용가"},"dcRate":{"type":"integer","format":"int32","description":"할인율"},"dispCtgNo":{"type":"array","description":"전시카테고리번호","items":{"$ref":"#/components/schemas/SearchProductCateData"}},"dlexTypCd":{"type":"string","description":"배송비유형코드"},"payWayMeanCd":{"type":"string","description":"결제수단코드정보"},"rservSaleYn":{"type":"string","description":"예약판매여부"},"goodsRevCnt":{"type":"integer","format":"int32","description":"상품리뷰건수"},"goodsRevHlpfulCnt":{"type":"integer","format":"int32","description":"상품리뷰도움돼요건수"},"goodsRevStarscrAvgVal":{"type":"integer","format":"int32","description":"상품리뷰별점평균값"},"wishListCnt":{"type":"string","description":"위시리스트수"},"goodsDtlDesc":{"type":"string","description":"상품상세설명"},"sendGb":{"type":"string","description":"전송구분"},"langCd":{"type":"string","description":"언어코드"},"extraData":{"type":"string","description":"ExtraData"},"goodsRepImgPathNm":{"type":"string","description":"상품 대표이미지"},"trnfTextCont":{"type":"string","description":"상품 대표이미지 대체텍스트"},"iconJson":{"type":"string","description":"ICON 정보"},"colorDataList":{"$ref":"#/components/schemas/SearchProductColorData","description":"색상 리스트"},"iconList":{"type":"array","items":{"type":"string"}}}},"SearchProductCateData":{"type":"object","description":"상품검색 요약정보 검색결과 카테고리정보","properties":{"dispCtgNo":{"type":"string","description":"전시카테고리번호"},"ctgFullPath":{"type":"string","description":"카테고리전체경로"},"ctgFullPathNm":{"type":"string","description":"카테고리전체경로명"},"siteNo":{"type":"string","description":"사이트번호"},"siteNm":{"type":"string","description":"사이트명"},"dpmlNo":{"type":"string","description":"몰번호"},"lrgCtgNm":{"type":"string","description":"대카테고리명"},"lrgCtgNo":{"type":"string","description":"대카테고리번호"}}},"SearchProductColorData":{"type":"object","properties":{"colorName":{"type":"string"},"subImageUrl":{"type":"string"},"score":{"type":"string"}}},"SearchProductBrandInfo":{"type":"object","properties":{"brandNo":{"type":"string"},"brandNm":{"type":"string"}}},"SearchLargeCategoryData":{"type":"object","properties":{"lrgCtgNm":{"type":"string","description":"대카테고리명"},"lrgCtgNo":{"type":"string","description":"대카테고리번호"},"count":{"type":"integer","format":"int32","description":"대카테고리그룹핑카운트"},"subCtgGrpData":{"type":"array","description":"중카테고리정보","items":{"$ref":"#/components/schemas/SearchSubCategoryData"}}}},"SearchSubCategoryData":{"type":"object","properties":{"subCtgNm":{"type":"string","description":"하위카테고리명"},"subCtgNo":{"type":"string","description":"하위카테고리번호"},"count":{"type":"integer","format":"int32","description":"하위카테고리그룹핑카운트"},"subCtgGrpData":{"description":"하위카테고리정보"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/search/product":{"get":{"tags":["상품검색"],"summary":"상품 조건 검색","description":"## 기능설명\n* 검색어에 조건을 추가하여 상품 목록을 검색한다.\n---\n## 상세설명\n* 검색 페이지의 정렬 조건, 필터 조건등을 추가하여 상품 목록을 검색할 수 있다.\n* 정렬 조건은 코드가 약속되어 있다. (10:판매순, 20:낮은가격순, 30:높은가격순, 40:할인율순, 50:최신순, 60:상품평많은순)\n* 필터 조건은 다양하게 추가가 가능하며 Search Swagger의 /goods를 참고하여 필요한 조건을 추가하여 사용한다.\n---\n## 수정번호\n* Release v1.04_231120 : 상품 조건 검색 추가, 상품 조건 검색 신규 추가\n","operationId":"seltSearchProduct","parameters":[{"name":"search","in":"query","required":true,"schema":{"$ref":"#/components/schemas/SearchRequest"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"상품 조건 검색 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/SearchProductResponse"}}}},"900":{"description":"상품 조건 검색 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```
## GET /v1/search/product-semantic
>
```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":{"SearchRequest":{"type":"object","description":"검색기본 Request","properties":{"searchWord":{"type":"string","description":"검색어"},"langCd":{"type":"string","description":"다국어코드"},"siteNo":{"type":"string","description":"사이트번호"},"sort":{"type":"string","description":"정렬구분코드"},"sortField":{"type":"string","description":"정렬대상항목"},"size":{"type":"string","description":"페이지당 노출수"},"from":{"type":"string","description":"페이지 시작점"},"filters":{"type":"string","description":"필터값"},"filter":{"type":"string","description":"필터값"},"minPrc":{"type":"integer","format":"int32","description":"최소가격"},"maxPrc":{"type":"integer","format":"int32","description":"최대가격"},"ctgNo":{"type":"string","description":"카테고리매장번호"},"vector":{"type":"array","description":"벡터 데이터","items":{"type":"string"}},"special":{"type":"string","description":"스페셜검색"}}},"SearchProductColorResponse":{"type":"object","description":"검색엔진 검색결과 DTO","properties":{"size":{"type":"string","description":"페이지당 노출수"},"from":{"type":"string","description":"페이지 시작점"},"totalCount":{"type":"integer","format":"int32","description":"총건수"},"searchDataList":{"type":"array","description":"상품 목록","items":{"$ref":"#/components/schemas/ProductSummaryColorResponse"}},"categoryDataList":{"type":"array","description":"카테고리 목록","items":{"$ref":"#/components/schemas/SearchProductCateData"}},"assocwordDataList":{"type":"array","description":"연관검색어 목록","items":{"type":"string"}},"brandDataList":{"type":"array","description":"브랜드 목록","items":{"$ref":"#/components/schemas/SearchProductBrandInfo"}},"lrgCtgGrpData":{"type":"array","description":"대카테고리정보","items":{"$ref":"#/components/schemas/SearchLargeCategoryData"}},"minPrc":{"type":"integer","format":"int32","description":"최소가격정보"},"maxPrc":{"type":"integer","format":"int32","description":"최대가격정보"}}},"ProductSummaryColorResponse":{"type":"object","description":"상품검색 요약정보 검색결과 DTO","properties":{"id":{"type":"string","description":"상품ID"},"goodsNo":{"type":"string","description":"상품번호"},"goodsNm":{"type":"string","description":"상품명"},"prestNm":{"type":"string","description":"증정품명"},"adveWrd":{"type":"string","description":"홍보문구"},"schKwdNm":{"type":"array","description":"검색키워드명","items":{"type":"string"}},"brandNo":{"type":"string","description":"브랜드번호"},"brandNm":{"type":"string","description":"브랜드명"},"buyrAgeLmtCd":{"type":"string","description":"구입자연령제한코드"},"goodsRegDtm":{"type":"string","format":"date-time","description":"상품등록일시"},"saleStatCd":{"type":"string","description":"판매상태코드"},"deliProcTypCd":{"type":"string","description":"배송처리유형코드"},"deliWayCd":{"type":"string","description":"배송수단코드"},"deliDday":{"type":"string","description":"배송기일"},"rcntSalePrc":{"type":"string","description":"최근판매가격"},"salePrc":{"type":"integer","format":"int32","description":"판매가"},"aplyPrc":{"type":"integer","format":"int32","description":"적용가"},"dcRate":{"type":"integer","format":"int32","description":"할인율"},"dispCtgNo":{"type":"array","description":"전시카테고리번호","items":{"$ref":"#/components/schemas/SearchProductCateData"}},"dlexTypCd":{"type":"string","description":"배송비유형코드"},"payWayMeanCd":{"type":"string","description":"결제수단코드정보"},"rservSaleYn":{"type":"string","description":"예약판매여부"},"goodsRevCnt":{"type":"integer","format":"int32","description":"상품리뷰건수"},"goodsRevHlpfulCnt":{"type":"integer","format":"int32","description":"상품리뷰도움돼요건수"},"goodsRevStarscrAvgVal":{"type":"integer","format":"int32","description":"상품리뷰별점평균값"},"wishListCnt":{"type":"string","description":"위시리스트수"},"goodsDtlDesc":{"type":"string","description":"상품상세설명"},"sendGb":{"type":"string","description":"전송구분"},"langCd":{"type":"string","description":"언어코드"},"extraData":{"type":"string","description":"ExtraData"},"goodsRepImgPathNm":{"type":"string","description":"상품 대표이미지"},"trnfTextCont":{"type":"string","description":"상품 대표이미지 대체텍스트"},"iconJson":{"type":"string","description":"ICON 정보"},"colorDataList":{"$ref":"#/components/schemas/SearchProductColorData","description":"색상 리스트"},"iconList":{"type":"array","items":{"type":"string"}}}},"SearchProductCateData":{"type":"object","description":"상품검색 요약정보 검색결과 카테고리정보","properties":{"dispCtgNo":{"type":"string","description":"전시카테고리번호"},"ctgFullPath":{"type":"string","description":"카테고리전체경로"},"ctgFullPathNm":{"type":"string","description":"카테고리전체경로명"},"siteNo":{"type":"string","description":"사이트번호"},"siteNm":{"type":"string","description":"사이트명"},"dpmlNo":{"type":"string","description":"몰번호"},"lrgCtgNm":{"type":"string","description":"대카테고리명"},"lrgCtgNo":{"type":"string","description":"대카테고리번호"}}},"SearchProductColorData":{"type":"object","properties":{"colorName":{"type":"string"},"subImageUrl":{"type":"string"},"score":{"type":"string"}}},"SearchProductBrandInfo":{"type":"object","properties":{"brandNo":{"type":"string"},"brandNm":{"type":"string"}}},"SearchLargeCategoryData":{"type":"object","properties":{"lrgCtgNm":{"type":"string","description":"대카테고리명"},"lrgCtgNo":{"type":"string","description":"대카테고리번호"},"count":{"type":"integer","format":"int32","description":"대카테고리그룹핑카운트"},"subCtgGrpData":{"type":"array","description":"중카테고리정보","items":{"$ref":"#/components/schemas/SearchSubCategoryData"}}}},"SearchSubCategoryData":{"type":"object","properties":{"subCtgNm":{"type":"string","description":"하위카테고리명"},"subCtgNo":{"type":"string","description":"하위카테고리번호"},"count":{"type":"integer","format":"int32","description":"하위카테고리그룹핑카운트"},"subCtgGrpData":{"description":"하위카테고리정보"}}}}},"paths":{"/v1/search/product-semantic":{"get":{"tags":["상품검색"],"operationId":"seltSearchProductSemantic","parameters":[{"name":"search","in":"query","required":true,"schema":{"$ref":"#/components/schemas/SearchRequest"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/SearchProductColorResponse"}}}}}}}}}
```
## 인기 검색어
> \## 기능설명\
> \* 현재부터 24시간 전까지 가장 많이 검색된 키워드 목록 상위 10개를 가져옵니다.\
> \---\
> \## 상세설명\
> \* 검색 페이지에서 인기 검색어를 보여줄 때 호출합니다.\
> \* 해당 기능은 파라미터를 필요로 하지 않습니다.\
> \* 검색된 키워드를 클릭할 경우 해당 키워드로 검색할 수 있게 구성할 수 있습니다.\
> \---\
> \## 수정번호\
> \* Release v1.04\_231120 : 검색페이지 인기검색어 추가, 검색페이지 인기검색어 신규 추가\
> \* Release v1.05\_240621 : 인기검색어 순위 증감 추가
```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":{"SearchRequest":{"type":"object","description":"검색기본 Request","properties":{"searchWord":{"type":"string","description":"검색어"},"langCd":{"type":"string","description":"다국어코드"},"siteNo":{"type":"string","description":"사이트번호"},"sort":{"type":"string","description":"정렬구분코드"},"sortField":{"type":"string","description":"정렬대상항목"},"size":{"type":"string","description":"페이지당 노출수"},"from":{"type":"string","description":"페이지 시작점"},"filters":{"type":"string","description":"필터값"},"filter":{"type":"string","description":"필터값"},"minPrc":{"type":"integer","format":"int32","description":"최소가격"},"maxPrc":{"type":"integer","format":"int32","description":"최대가격"},"ctgNo":{"type":"string","description":"카테고리매장번호"},"vector":{"type":"array","description":"벡터 데이터","items":{"type":"string"}},"special":{"type":"string","description":"스페셜검색"}}},"SearchPopularKeywords":{"type":"object","properties":{"keyword":{"type":"string","description":"키워드"},"changeType":{"type":"integer","format":"int32","description":"인기순위 증감"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/search/popularKeword":{"get":{"tags":["상품검색"],"summary":"인기 검색어","description":"## 기능설명\n* 현재부터 24시간 전까지 가장 많이 검색된 키워드 목록 상위 10개를 가져옵니다.\n---\n## 상세설명\n* 검색 페이지에서 인기 검색어를 보여줄 때 호출합니다.\n* 해당 기능은 파라미터를 필요로 하지 않습니다.\n* 검색된 키워드를 클릭할 경우 해당 키워드로 검색할 수 있게 구성할 수 있습니다.\n---\n## 수정번호\n* Release v1.04_231120 : 검색페이지 인기검색어 추가, 검색페이지 인기검색어 신규 추가\n* Release v1.05_240621 : 인기검색어 순위 증감 추가\n","operationId":"seltPopularWrdList","parameters":[{"name":"search","in":"query","required":true,"schema":{"$ref":"#/components/schemas/SearchRequest"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"인기검색어 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/SearchPopularKeywords"}}}},"900":{"description":"인기검색어 조회 실패","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, and the optional `goal` query parameter:
```
GET https://tech.x2bee.com/api/store-front-api/goods-api/undefined-3.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.