> 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"}}}}}}}}}
```