> 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/api-en/store-front-api-reference/goods-api/product-search.md).
# Product Search
## Integrated Product Search
> \## Function Description\
> \* Shows the integrated search results for products.\
> \---\
> \## Detailed Description\
> \* Called when performing a keyword search on the search page.\
> \* Shows the integrated information of products for the search term.\
> \* The integrated search results consist of the product list, category list, brand list, and related search term list.\
> \---\
> \## Revision History\
> \* Release v1.04\_231120 : Search page integrated search, newly added search page integrated search
```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":"Search Basic Request","properties":{"searchWord":{"type":"string","description":"Search Term"},"langCd":{"type":"string","description":"Multilingual Code"},"siteNo":{"type":"string","description":"Site No."},"sort":{"type":"string","description":"Sort Type Code"},"sortField":{"type":"string","description":"Sort Target Item"},"size":{"type":"string","description":"Items Displayed per Page"},"from":{"type":"string","description":"Page Start Point"},"filters":{"type":"string","description":"Filter Value"},"filter":{"type":"string","description":"Filter Value"},"minPrc":{"type":"integer","format":"int32","description":"Minimum Price"},"maxPrc":{"type":"integer","format":"int32","description":"Maximum Price"},"ctgNo":{"type":"string","description":"Category Store No."},"vector":{"type":"array","description":"Vector Data","items":{"type":"string"}},"special":{"type":"string","description":"Special Search"}}},"SearchProductResponse":{"type":"object","description":"Search Engine Search Result DTO","properties":{"size":{"type":"string","description":"Items Displayed per Page"},"from":{"type":"string","description":"Page Start Point"},"totalCount":{"type":"integer","format":"int32","description":"Total Count"},"searchDataList":{"type":"array","description":"Product List","items":{"$ref":"#/components/schemas/ProductSummaryResponse"}},"categoryDataList":{"type":"array","description":"Category List","items":{"$ref":"#/components/schemas/SearchProductCateData"}},"assocwordDataList":{"type":"array","description":"Related Search Term List","items":{"type":"string"}},"brandDataList":{"type":"array","description":"Brand List","items":{"$ref":"#/components/schemas/SearchProductBrandInfo"}},"lrgCtgGrpData":{"type":"array","description":"Top-Level Category Information","items":{"$ref":"#/components/schemas/SearchLargeCategoryData"}},"minPrc":{"type":"integer","format":"int32","description":"Minimum Price Information"},"maxPrc":{"type":"integer","format":"int32","description":"Maximum Price Information"}}},"ProductSummaryResponse":{"type":"object","description":"Product Search Summary Information Search Result DTO","properties":{"id":{"type":"string","description":"Product ID"},"goodsNo":{"type":"string","description":"Product No."},"goodsNm":{"type":"string","description":"Product Name"},"prestNm":{"type":"string","description":"Gift Item Name"},"adveWrd":{"type":"string","description":"Promotional Text"},"schKwdNm":{"type":"array","description":"Search Keyword","items":{"type":"string"}},"brandNo":{"type":"string","description":"Brand No."},"brandNm":{"type":"string","description":"Brand Name"},"buyrAgeLmtCd":{"type":"string","description":"Purchaser Age Restriction Code"},"goodsRegDtm":{"type":"string","format":"date-time","description":"Product Registration Date/Time"},"saleStatCd":{"type":"string","description":"Sales Status Code"},"deliProcTypCd":{"type":"string","description":"Delivery Processing Type Code"},"deliWayCd":{"type":"string","description":"Delivery Method Code"},"deliDday":{"type":"string","description":"Delivery Lead Time"},"rcntSalePrc":{"type":"string","description":"Recent Selling Price"},"salePrc":{"type":"number","description":"Selling Price"},"aplyPrc":{"type":"number","description":"Applied Price"},"dcRate":{"type":"integer","format":"int32","description":"Discount Rate"},"dispCtgNo":{"type":"array","description":"Display Category No.","items":{"$ref":"#/components/schemas/SearchProductCateData"}},"dlexTypCd":{"type":"string","description":"Delivery Fee Type Code"},"payWayMeanCd":{"type":"string","description":"Payment Method Code Information"},"rservSaleYn":{"type":"string","description":"Reservation Sale Status"},"goodsRevCnt":{"type":"integer","format":"int32","description":"Product Review Count"},"goodsRevHlpfulCnt":{"type":"integer","format":"int32","description":"Product Review Helpful Count"},"goodsRevStarscrAvgVal":{"type":"integer","format":"int32","description":"Product Review Average Rating"},"wishListCnt":{"type":"string","description":"Wishlist Count"},"goodsDtlDesc":{"type":"string","description":"Product Detailed Description"},"sendGb":{"type":"string","description":"Transmission Type"},"langCd":{"type":"string","description":"Language Code"},"extraData":{"type":"string","description":"ExtraData"},"goodsRepImgPathNm":{"type":"string","description":"Product Main Image"},"trnfTextCont":{"type":"string","description":"Product Main Image Alt Text"},"iconJson":{"type":"string","description":"ICON Information"},"colorDataList":{"$ref":"#/components/schemas/SearchProductColorData","description":"Color List"},"iconList":{"type":"array","items":{"type":"string"}}}},"SearchProductCateData":{"type":"object","description":"Product Search Summary Info Search Result Category Info","properties":{"dispCtgNo":{"type":"string","description":"Display Category No."},"ctgFullPath":{"type":"string","description":"Full Category Path"},"ctgFullPathNm":{"type":"string","description":"Full Category Path Name"},"siteNo":{"type":"string","description":"Site No."},"siteNm":{"type":"string","description":"Site Name"},"dpmlNo":{"type":"string","description":"Mall No."},"lrgCtgNm":{"type":"string","description":"Large Category Name"},"lrgCtgNo":{"type":"string","description":"Large Category No."}}},"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":"Large Category Name"},"lrgCtgNo":{"type":"string","description":"Large Category No."},"count":{"type":"integer","format":"int32","description":"Large Category Grouping Count"},"subCtgGrpData":{"type":"array","description":"Medium Category Info","items":{"$ref":"#/components/schemas/SearchSubCategoryData"}}}},"SearchSubCategoryData":{"type":"object","properties":{"subCtgNm":{"type":"string","description":"Sub-Category Name"},"subCtgNo":{"type":"string","description":"Sub-Category No."},"count":{"type":"integer","format":"int32","description":"Sub-Category Grouping Count"},"subCtgGrpData":{"description":"Sub-Category Info"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/search/search":{"post":{"tags":["Product Search"],"summary":"Integrated Product Search","description":"## Function Description\n* Shows the integrated search results for products.\n---\n## Detailed Description\n* Called when performing a keyword search on the search page.\n* Shows the integrated information of products for the search term.\n* The integrated search results consist of the product list, category list, brand list, and related search term list.\n---\n## Revision History\n* Release v1.04_231120 : Search page integrated search, newly added search page integrated search\n","operationId":"seltSearchEngine","parameters":[{"name":"searchWord","in":"query","description":"Search Keywords","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":"Integrated Product Search Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/SearchProductResponse"}}}},"900":{"description":"Integrated Product Search Failure","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":"Search Basic Request","properties":{"searchWord":{"type":"string","description":"Search Term"},"langCd":{"type":"string","description":"Multilingual Code"},"siteNo":{"type":"string","description":"Site No."},"sort":{"type":"string","description":"Sort Type Code"},"sortField":{"type":"string","description":"Sort Target Item"},"size":{"type":"string","description":"Items Displayed per Page"},"from":{"type":"string","description":"Page Start Point"},"filters":{"type":"string","description":"Filter Value"},"filter":{"type":"string","description":"Filter Value"},"minPrc":{"type":"integer","format":"int32","description":"Minimum Price"},"maxPrc":{"type":"integer","format":"int32","description":"Maximum Price"},"ctgNo":{"type":"string","description":"Category Store No."},"vector":{"type":"array","description":"Vector Data","items":{"type":"string"}},"special":{"type":"string","description":"Special Search"}}},"SearchProductResponse":{"type":"object","description":"Search Engine Search Result DTO","properties":{"size":{"type":"string","description":"Items Displayed per Page"},"from":{"type":"string","description":"Page Start Point"},"totalCount":{"type":"integer","format":"int32","description":"Total Count"},"searchDataList":{"type":"array","description":"Product List","items":{"$ref":"#/components/schemas/ProductSummaryResponse"}},"categoryDataList":{"type":"array","description":"Category List","items":{"$ref":"#/components/schemas/SearchProductCateData"}},"assocwordDataList":{"type":"array","description":"Related Search Term List","items":{"type":"string"}},"brandDataList":{"type":"array","description":"Brand List","items":{"$ref":"#/components/schemas/SearchProductBrandInfo"}},"lrgCtgGrpData":{"type":"array","description":"Top-Level Category Information","items":{"$ref":"#/components/schemas/SearchLargeCategoryData"}},"minPrc":{"type":"integer","format":"int32","description":"Minimum Price Information"},"maxPrc":{"type":"integer","format":"int32","description":"Maximum Price Information"}}},"ProductSummaryResponse":{"type":"object","description":"Product Search Summary Information Search Result DTO","properties":{"id":{"type":"string","description":"Product ID"},"goodsNo":{"type":"string","description":"Product No."},"goodsNm":{"type":"string","description":"Product Name"},"prestNm":{"type":"string","description":"Gift Item Name"},"adveWrd":{"type":"string","description":"Promotional Text"},"schKwdNm":{"type":"array","description":"Search Keyword","items":{"type":"string"}},"brandNo":{"type":"string","description":"Brand No."},"brandNm":{"type":"string","description":"Brand Name"},"buyrAgeLmtCd":{"type":"string","description":"Purchaser Age Restriction Code"},"goodsRegDtm":{"type":"string","format":"date-time","description":"Product Registration Date/Time"},"saleStatCd":{"type":"string","description":"Sales Status Code"},"deliProcTypCd":{"type":"string","description":"Delivery Processing Type Code"},"deliWayCd":{"type":"string","description":"Delivery Method Code"},"deliDday":{"type":"string","description":"Delivery Lead Time"},"rcntSalePrc":{"type":"string","description":"Recent Selling Price"},"salePrc":{"type":"number","description":"Selling Price"},"aplyPrc":{"type":"number","description":"Applied Price"},"dcRate":{"type":"integer","format":"int32","description":"Discount Rate"},"dispCtgNo":{"type":"array","description":"Display Category No.","items":{"$ref":"#/components/schemas/SearchProductCateData"}},"dlexTypCd":{"type":"string","description":"Delivery Fee Type Code"},"payWayMeanCd":{"type":"string","description":"Payment Method Code Information"},"rservSaleYn":{"type":"string","description":"Reservation Sale Status"},"goodsRevCnt":{"type":"integer","format":"int32","description":"Product Review Count"},"goodsRevHlpfulCnt":{"type":"integer","format":"int32","description":"Product Review Helpful Count"},"goodsRevStarscrAvgVal":{"type":"integer","format":"int32","description":"Product Review Average Rating"},"wishListCnt":{"type":"string","description":"Wishlist Count"},"goodsDtlDesc":{"type":"string","description":"Product Detailed Description"},"sendGb":{"type":"string","description":"Transmission Type"},"langCd":{"type":"string","description":"Language Code"},"extraData":{"type":"string","description":"ExtraData"},"goodsRepImgPathNm":{"type":"string","description":"Product Main Image"},"trnfTextCont":{"type":"string","description":"Product Main Image Alt Text"},"iconJson":{"type":"string","description":"ICON Information"},"colorDataList":{"$ref":"#/components/schemas/SearchProductColorData","description":"Color List"},"iconList":{"type":"array","items":{"type":"string"}}}},"SearchProductCateData":{"type":"object","description":"Product Search Summary Info Search Result Category Info","properties":{"dispCtgNo":{"type":"string","description":"Display Category No."},"ctgFullPath":{"type":"string","description":"Full Category Path"},"ctgFullPathNm":{"type":"string","description":"Full Category Path Name"},"siteNo":{"type":"string","description":"Site No."},"siteNm":{"type":"string","description":"Site Name"},"dpmlNo":{"type":"string","description":"Mall No."},"lrgCtgNm":{"type":"string","description":"Large Category Name"},"lrgCtgNo":{"type":"string","description":"Large Category No."}}},"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":"Large Category Name"},"lrgCtgNo":{"type":"string","description":"Large Category No."},"count":{"type":"integer","format":"int32","description":"Large Category Grouping Count"},"subCtgGrpData":{"type":"array","description":"Medium Category Info","items":{"$ref":"#/components/schemas/SearchSubCategoryData"}}}},"SearchSubCategoryData":{"type":"object","properties":{"subCtgNm":{"type":"string","description":"Sub-Category Name"},"subCtgNo":{"type":"string","description":"Sub-Category No."},"count":{"type":"integer","format":"int32","description":"Sub-Category Grouping Count"},"subCtgGrpData":{"description":"Sub-Category Info"}}}}},"paths":{"/v1/search/product-image":{"post":{"tags":["Product Search"],"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"}}}}}}}}}
```
## Exhibition Search
> \## Function Description\
> \* Searches for exhibition information related to the search term.\
> \---\
> \## Detailed Description\
> \* Provides related exhibition information when a search term is entered.\
> \* Exhibition search supports multiple languages, and the multilingual code (langCd: ko, en, etc.) is required as a parameter.\
> \* Any additional required information can be added to and used in the extraData field.\
> \* Searches for exhibitions matching the given conditions using the search term, category, filter, and other values.\
> \---\
> \## Revision History\
> \* Release v1.04\_231120 : Added search page exhibition search, newly added search page exhibition search
```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":"Search Basic Request","properties":{"searchWord":{"type":"string","description":"Search Term"},"langCd":{"type":"string","description":"Multilingual Code"},"siteNo":{"type":"string","description":"Site No."},"sort":{"type":"string","description":"Sort Type Code"},"sortField":{"type":"string","description":"Sort Target Item"},"size":{"type":"string","description":"Items Displayed per Page"},"from":{"type":"string","description":"Page Start Point"},"filters":{"type":"string","description":"Filter Value"},"filter":{"type":"string","description":"Filter Value"},"minPrc":{"type":"integer","format":"int32","description":"Minimum Price"},"maxPrc":{"type":"integer","format":"int32","description":"Maximum Price"},"ctgNo":{"type":"string","description":"Category Store No."},"vector":{"type":"array","description":"Vector Data","items":{"type":"string"}},"special":{"type":"string","description":"Special Search"}}},"SearchExhibitionInfo":{"type":"object","properties":{"id":{"type":"string","description":"Special Exhibition No."},"mkdpNo":{"type":"string","description":"Special Exhibition No."},"title":{"type":"string","description":"Special Exhibition Name"},"description":{"type":"string","description":"Exhibition Description"},"schKwdNm":{"type":"string","description":"Keyword Name"},"brandCodes":{"type":"string","description":"Brand Numbers"},"brandImgPathNm":{"type":"string","description":"Banner Image Path Name"},"altCont":{"type":"string","description":"Banner Image Alt Text"},"dispStrDtm":{"type":"string","format":"date-time","description":"Exhibition Start Date/Time"},"dispEndDtm":{"type":"string","format":"date-time","description":"Exhibition End Date/Time"},"extraData":{"type":"string","description":"Additional Data"},"langCd":{"type":"string","description":"Language Code"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/search/marketing":{"post":{"tags":["Product Search"],"summary":"Exhibition Search","description":"## Function Description\n* Searches for exhibition information related to the search term.\n---\n## Detailed Description\n* Provides related exhibition information when a search term is entered.\n* Exhibition search supports multiple languages, and the multilingual code (langCd: ko, en, etc.) is required as a parameter.\n* Any additional required information can be added to and used in the extraData field.\n* Searches for exhibitions matching the given conditions using the search term, category, filter, and other values.\n---\n## Revision History\n* Release v1.04_231120 : Added search page exhibition search, newly added search page exhibition search\n","operationId":"seltExhibiionList","parameters":[{"name":"searchWord","in":"query","description":"Search Keywords","required":true,"schema":{"type":"string"}},{"name":"langCd","in":"query","description":"Multilingual Code","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":"Exhibition Search Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/SearchExhibitionInfo"}}}},"900":{"description":"Exhibition Search Failure","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```
## Event Search
> \## Function Description\
> \* Searches for event information related to the search term.\
> \---\
> \## Detailed Description\
> \* Provides related event information when a search term is entered.\
> \* Any additional required information can be added to and used in the extraData field.\
> \* Searches for events matching the given conditions using the search term, category, filter, and other values.\
> \---\
> \## Revision History\
> \* Release v1.04\_231120 : Added search page event search, newly added search page event search
```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":"Search Basic Request","properties":{"searchWord":{"type":"string","description":"Search Term"},"langCd":{"type":"string","description":"Multilingual Code"},"siteNo":{"type":"string","description":"Site No."},"sort":{"type":"string","description":"Sort Type Code"},"sortField":{"type":"string","description":"Sort Target Item"},"size":{"type":"string","description":"Items Displayed per Page"},"from":{"type":"string","description":"Page Start Point"},"filters":{"type":"string","description":"Filter Value"},"filter":{"type":"string","description":"Filter Value"},"minPrc":{"type":"integer","format":"int32","description":"Minimum Price"},"maxPrc":{"type":"integer","format":"int32","description":"Maximum Price"},"ctgNo":{"type":"string","description":"Category Store No."},"vector":{"type":"array","description":"Vector Data","items":{"type":"string"}},"special":{"type":"string","description":"Special Search"}}},"SearchEventInfo":{"type":"object","properties":{"id":{"type":"string","description":"Event No."},"evtNo":{"type":"string","description":"Event No."},"title":{"type":"string","description":"Event Name"},"description":{"type":"string","description":"Promotional Text Content"},"schKwdNm":{"type":"string","description":"Event Search Tag"},"sendGb":{"type":"string","description":"Transmission Type Code"},"extraData":{"type":"string","description":"Additional Data"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/search/event":{"post":{"tags":["Product Search"],"summary":"Event Search","description":"## Function Description\n* Searches for event information related to the search term.\n---\n## Detailed Description\n* Provides related event information when a search term is entered.\n* Any additional required information can be added to and used in the extraData field.\n* Searches for events matching the given conditions using the search term, category, filter, and other values.\n---\n## Revision History\n* Release v1.04_231120 : Added search page event search, newly added search page event search\n","operationId":"seltEventList","parameters":[{"name":"searchWord","in":"query","description":"Search Keywords","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":"Event Search Retrieved Successfully","content":{"*/*":{"schema":{"$ref":"#/components/schemas/SearchEventInfo"}}}},"900":{"description":"Event Search Retrieval Failed","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":"Total Count"},"searchDataList":{"type":"array","description":"Search Result List","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":["Product Search"],"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":"Total Count"},"searchDataList":{"type":"array","description":"Search Result List","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":["Product Search"],"operationId":"seltSearchMarkupWord","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/SearchResultResponseSearchRecommendWord"}}}}}}}}}
```
## Retrieve Default Search Text
> \## Function Description\
> \* This API retrieves the default search text.\
> \---\
> \## Detailed Description\
> \* Retrieves using the language code stored in the cookie.\
> \* Retrieves recommended search terms whose application period is current and whose usage status is '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":"Default Search Text DTO","properties":{"langCd":{"type":"string","description":"Language Code (CM009)"},"baseSchWrdWrd":{"type":"string","description":"Default Search Term Phrase"},"schWrd":{"type":"string","description":"Search Term"},"schBaseWrdSeq":{"type":"string","description":"Default Search Phrase Sequence No."},"aplyStrDtm":{"type":"string","format":"date-time","description":"Application Start Date/Time"},"aplyEndDtm":{"type":"string","format":"date-time","description":"Application End Date/Time"},"linkUrlAddr":{"type":"string","description":"Linked URL"},"useYn":{"type":"string","description":"Usage Status"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/search/schBaseWrdList":{"get":{"tags":["Product Search"],"summary":"Retrieve Default Search Text","description":"## Function Description\n* This API retrieves the default search text.\n---\n## Detailed Description\n* Retrieves using the language code stored in the cookie.\n* Retrieves recommended search terms whose application period is current and whose usage status is 'Y'.\n","operationId":"seltSchBaseWrdList","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"Default Search Text Inquiry Success","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/PrSchBaseWrdInfo"}}}}},"900":{"description":"Default Search Text Inquiry Failure","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```
## Recommended Search Term
> \## Function Description\
> \* Returns recommended search terms for the entered search term.\
> \---\
> \## Detailed Description\
> \* Used to show related recommended search terms when a search term is entered.\
> \* If linked in real time as keywords are entered, this can be implemented with the same functionality as autocomplete.\
> \* The final responses are sent as an array in the list node. ( {list:\[{responses}]} )\
> \---\
> \## Revision History\
> \* Release v1.04\_231120 : Added search page autocomplete words, newly added search page autocomplete words\
> \* \`\`\`Release v2.00\_240627\`\`\` : Expanded the autocomplete word targets to products, exhibitions, events, categories, and brands
````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":"Recommended Item"},"item":{"$ref":"#/components/schemas/SearchBrandCateInfo","description":"Recommended Search Term"}}},"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":["Product Search"],"summary":"Recommended Search Term","description":"## Function Description\n* Returns recommended search terms for the entered search term.\n---\n## Detailed Description\n* Used to show related recommended search terms when a search term is entered.\n* If linked in real time as keywords are entered, this can be implemented with the same functionality as autocomplete.\n* The final responses are sent as an array in the list node. ( {list:[{responses}]} )\n---\n## Revision History\n* Release v1.04_231120 : Added search page autocomplete words, newly added search page autocomplete words\n* ```Release v2.00_240627``` : Expanded the autocomplete word targets to products, exhibitions, events, categories, and brands\n","operationId":"seltRecommendationList","parameters":[{"name":"searchWord","in":"query","description":"Search Keywords","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"Recommended Search Term Retrieved Successfully","content":{"*/*":{"schema":{"$ref":"#/components/schemas/SearchRecommKeywords"}}}},"900":{"description":"Recommended Search Term Retrieval Failed","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
````
## Search Box Markup and Recommended Search Terms
> \## Function Description\
> \* Provides search box markup and recommended search term word information registered in the BO.\
> \---\
> \## Detailed Description\
> \* Related BO menu: Product > Search Term Management > Recommended Search Terms, BO Product > Search Term Management > Markup Search Terms\
> \* Provides the most recently modified content among the recommended search terms and markup search terms.\
> \* The provided content can be used to draw users to an intended product or exhibition page by displaying it by default in the search box when entering the search page.\
> \---\
> \## Revision History\
> \* Release v1.04\_231120 : Added search box markup and recommended search terms, newly added search box markup and recommended search terms
```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":["Product Search"],"summary":"Search Box Markup and Recommended Search Terms","description":"## Function Description\n* Provides search box markup and recommended search term word information registered in the BO.\n---\n## Detailed Description\n* Related BO menu: Product > Search Term Management > Recommended Search Terms, BO Product > Search Term Management > Markup Search Terms\n* Provides the most recently modified content among the recommended search terms and markup search terms.\n* The provided content can be used to draw users to an intended product or exhibition page by displaying it by default in the search box when entering the search page.\n---\n## Revision History\n* Release v1.04_231120 : Added search box markup and recommended search terms, newly added search box markup and recommended search terms\n","operationId":"seltRecommendWord","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"Event Search Retrieved Successfully","content":{"*/*":{"schema":{"$ref":"#/components/schemas/SearchRecommendWord"}}}},"900":{"description":"Event Search Retrieval Failed","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```
## Retrieve Recommended Search Terms
> \## Function Description\
> \* This API retrieves recommended search terms.\
> \---\
> \## Detailed Description\
> \* Retrieves using the language code stored in the cookie.\
> \* Retrieves recommended search terms whose application period is current and whose usage status is '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":"Recommended Search Term DTO","properties":{"langCd":{"type":"string","description":"Language Code (CM009)"},"recomSchWrd":{"type":"string","description":"Recommended Search Term"},"recomSchWrdSeq":{"type":"string","description":"Recommended Search Term Sequence No."},"aplyStrDtm":{"type":"string","format":"date-time","description":"Application Start Date/Time"},"aplyEndDtm":{"type":"string","format":"date-time","description":"Application End Date/Time"},"sortSeq":{"type":"string","description":"Sort Order"},"useYn":{"type":"string","description":"Usage Status"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/search/recomSchWrdList":{"get":{"tags":["Product Search"],"summary":"Retrieve Recommended Search Terms","description":"## Function Description\n* This API retrieves recommended search terms.\n---\n## Detailed Description\n* Retrieves using the language code stored in the cookie.\n* Retrieves recommended search terms whose application period is current and whose usage status is 'Y'.\n","operationId":"seltRecomSchWrdList","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"Recommended Search Term Retrieved Successfully","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/PrRecomSchWrdInfo"}}}}},"900":{"description":"Recommended Search Term Retrieval Failed","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```
## Product Conditional Search
> \## Function Description\
> \* Searches the product list by adding conditions to the search term.\
> \---\
> \## Detailed Description\
> \* The product list can be searched by adding the search page's sort conditions, filter conditions, etc.\
> \* Sort conditions use predefined codes. (10: Best-selling, 20: Lowest price, 30: Highest price, 40: Highest discount rate, 50: Newest, 60: Most reviewed)\
> \* Filter conditions can be added in various ways; refer to /goods in the Search Swagger and add the necessary conditions for use.\
> \---\
> \## Revision History\
> \* Release v1.04\_231120 : Added product conditional search, newly added product conditional search
```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":"Search Basic Request","properties":{"searchWord":{"type":"string","description":"Search Term"},"langCd":{"type":"string","description":"Multilingual Code"},"siteNo":{"type":"string","description":"Site No."},"sort":{"type":"string","description":"Sort Type Code"},"sortField":{"type":"string","description":"Sort Target Item"},"size":{"type":"string","description":"Items Displayed per Page"},"from":{"type":"string","description":"Page Start Point"},"filters":{"type":"string","description":"Filter Value"},"filter":{"type":"string","description":"Filter Value"},"minPrc":{"type":"integer","format":"int32","description":"Minimum Price"},"maxPrc":{"type":"integer","format":"int32","description":"Maximum Price"},"ctgNo":{"type":"string","description":"Category Store No."},"vector":{"type":"array","description":"Vector Data","items":{"type":"string"}},"special":{"type":"string","description":"Special Search"}}},"SearchProductResponse":{"type":"object","description":"Search Engine Search Result DTO","properties":{"size":{"type":"string","description":"Items Displayed per Page"},"from":{"type":"string","description":"Page Start Point"},"totalCount":{"type":"integer","format":"int32","description":"Total Count"},"searchDataList":{"type":"array","description":"Product List","items":{"$ref":"#/components/schemas/ProductSummaryResponse"}},"categoryDataList":{"type":"array","description":"Category List","items":{"$ref":"#/components/schemas/SearchProductCateData"}},"assocwordDataList":{"type":"array","description":"Related Search Term List","items":{"type":"string"}},"brandDataList":{"type":"array","description":"Brand List","items":{"$ref":"#/components/schemas/SearchProductBrandInfo"}},"lrgCtgGrpData":{"type":"array","description":"Top-Level Category Information","items":{"$ref":"#/components/schemas/SearchLargeCategoryData"}},"minPrc":{"type":"integer","format":"int32","description":"Minimum Price Information"},"maxPrc":{"type":"integer","format":"int32","description":"Maximum Price Information"}}},"ProductSummaryResponse":{"type":"object","description":"Product Search Summary Information Search Result DTO","properties":{"id":{"type":"string","description":"Product ID"},"goodsNo":{"type":"string","description":"Product No."},"goodsNm":{"type":"string","description":"Product Name"},"prestNm":{"type":"string","description":"Gift Item Name"},"adveWrd":{"type":"string","description":"Promotional Text"},"schKwdNm":{"type":"array","description":"Search Keyword","items":{"type":"string"}},"brandNo":{"type":"string","description":"Brand No."},"brandNm":{"type":"string","description":"Brand Name"},"buyrAgeLmtCd":{"type":"string","description":"Purchaser Age Restriction Code"},"goodsRegDtm":{"type":"string","format":"date-time","description":"Product Registration Date/Time"},"saleStatCd":{"type":"string","description":"Sales Status Code"},"deliProcTypCd":{"type":"string","description":"Delivery Processing Type Code"},"deliWayCd":{"type":"string","description":"Delivery Method Code"},"deliDday":{"type":"string","description":"Delivery Lead Time"},"rcntSalePrc":{"type":"string","description":"Recent Selling Price"},"salePrc":{"type":"number","description":"Selling Price"},"aplyPrc":{"type":"number","description":"Applied Price"},"dcRate":{"type":"integer","format":"int32","description":"Discount Rate"},"dispCtgNo":{"type":"array","description":"Display Category No.","items":{"$ref":"#/components/schemas/SearchProductCateData"}},"dlexTypCd":{"type":"string","description":"Delivery Fee Type Code"},"payWayMeanCd":{"type":"string","description":"Payment Method Code Information"},"rservSaleYn":{"type":"string","description":"Reservation Sale Status"},"goodsRevCnt":{"type":"integer","format":"int32","description":"Product Review Count"},"goodsRevHlpfulCnt":{"type":"integer","format":"int32","description":"Product Review Helpful Count"},"goodsRevStarscrAvgVal":{"type":"integer","format":"int32","description":"Product Review Average Rating"},"wishListCnt":{"type":"string","description":"Wishlist Count"},"goodsDtlDesc":{"type":"string","description":"Product Detailed Description"},"sendGb":{"type":"string","description":"Transmission Type"},"langCd":{"type":"string","description":"Language Code"},"extraData":{"type":"string","description":"ExtraData"},"goodsRepImgPathNm":{"type":"string","description":"Product Main Image"},"trnfTextCont":{"type":"string","description":"Product Main Image Alt Text"},"iconJson":{"type":"string","description":"ICON Information"},"colorDataList":{"$ref":"#/components/schemas/SearchProductColorData","description":"Color List"},"iconList":{"type":"array","items":{"type":"string"}}}},"SearchProductCateData":{"type":"object","description":"Product Search Summary Info Search Result Category Info","properties":{"dispCtgNo":{"type":"string","description":"Display Category No."},"ctgFullPath":{"type":"string","description":"Full Category Path"},"ctgFullPathNm":{"type":"string","description":"Full Category Path Name"},"siteNo":{"type":"string","description":"Site No."},"siteNm":{"type":"string","description":"Site Name"},"dpmlNo":{"type":"string","description":"Mall No."},"lrgCtgNm":{"type":"string","description":"Large Category Name"},"lrgCtgNo":{"type":"string","description":"Large Category No."}}},"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":"Large Category Name"},"lrgCtgNo":{"type":"string","description":"Large Category No."},"count":{"type":"integer","format":"int32","description":"Large Category Grouping Count"},"subCtgGrpData":{"type":"array","description":"Medium Category Info","items":{"$ref":"#/components/schemas/SearchSubCategoryData"}}}},"SearchSubCategoryData":{"type":"object","properties":{"subCtgNm":{"type":"string","description":"Sub-Category Name"},"subCtgNo":{"type":"string","description":"Sub-Category No."},"count":{"type":"integer","format":"int32","description":"Sub-Category Grouping Count"},"subCtgGrpData":{"description":"Sub-Category Info"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/search/product":{"get":{"tags":["Product Search"],"summary":"Product Conditional Search","description":"## Function Description\n* Searches the product list by adding conditions to the search term.\n---\n## Detailed Description\n* The product list can be searched by adding the search page's sort conditions, filter conditions, etc.\n* Sort conditions use predefined codes. (10: Best-selling, 20: Lowest price, 30: Highest price, 40: Highest discount rate, 50: Newest, 60: Most reviewed)\n* Filter conditions can be added in various ways; refer to /goods in the Search Swagger and add the necessary conditions for use.\n---\n## Revision History\n* Release v1.04_231120 : Added product conditional search, newly added product conditional search\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":"Product Conditional Search Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/SearchProductResponse"}}}},"900":{"description":"Product Conditional Search Failure","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":"Search Basic Request","properties":{"searchWord":{"type":"string","description":"Search Term"},"langCd":{"type":"string","description":"Multilingual Code"},"siteNo":{"type":"string","description":"Site No."},"sort":{"type":"string","description":"Sort Type Code"},"sortField":{"type":"string","description":"Sort Target Item"},"size":{"type":"string","description":"Items Displayed per Page"},"from":{"type":"string","description":"Page Start Point"},"filters":{"type":"string","description":"Filter Value"},"filter":{"type":"string","description":"Filter Value"},"minPrc":{"type":"integer","format":"int32","description":"Minimum Price"},"maxPrc":{"type":"integer","format":"int32","description":"Maximum Price"},"ctgNo":{"type":"string","description":"Category Store No."},"vector":{"type":"array","description":"Vector Data","items":{"type":"string"}},"special":{"type":"string","description":"Special Search"}}},"SearchProductColorResponse":{"type":"object","description":"Search Engine Search Result DTO","properties":{"size":{"type":"string","description":"Items Displayed per Page"},"from":{"type":"string","description":"Page Start Point"},"totalCount":{"type":"integer","format":"int32","description":"Total Count"},"searchDataList":{"type":"array","description":"Product List","items":{"$ref":"#/components/schemas/ProductSummaryColorResponse"}},"categoryDataList":{"type":"array","description":"Category List","items":{"$ref":"#/components/schemas/SearchProductCateData"}},"assocwordDataList":{"type":"array","description":"Related Search Term List","items":{"type":"string"}},"brandDataList":{"type":"array","description":"Brand List","items":{"$ref":"#/components/schemas/SearchProductBrandInfo"}},"lrgCtgGrpData":{"type":"array","description":"Top-Level Category Information","items":{"$ref":"#/components/schemas/SearchLargeCategoryData"}},"minPrc":{"type":"integer","format":"int32","description":"Minimum Price Information"},"maxPrc":{"type":"integer","format":"int32","description":"Maximum Price Information"}}},"ProductSummaryColorResponse":{"type":"object","description":"Product Search Summary Information Search Result DTO","properties":{"id":{"type":"string","description":"Product ID"},"goodsNo":{"type":"string","description":"Product No."},"goodsNm":{"type":"string","description":"Product Name"},"prestNm":{"type":"string","description":"Gift Item Name"},"adveWrd":{"type":"string","description":"Promotional Text"},"schKwdNm":{"type":"array","description":"Search Keyword","items":{"type":"string"}},"brandNo":{"type":"string","description":"Brand No."},"brandNm":{"type":"string","description":"Brand Name"},"buyrAgeLmtCd":{"type":"string","description":"Purchaser Age Restriction Code"},"goodsRegDtm":{"type":"string","format":"date-time","description":"Product Registration Date/Time"},"saleStatCd":{"type":"string","description":"Sales Status Code"},"deliProcTypCd":{"type":"string","description":"Delivery Processing Type Code"},"deliWayCd":{"type":"string","description":"Delivery Method Code"},"deliDday":{"type":"string","description":"Delivery Lead Time"},"rcntSalePrc":{"type":"string","description":"Recent Selling Price"},"salePrc":{"type":"integer","format":"int32","description":"Selling Price"},"aplyPrc":{"type":"integer","format":"int32","description":"Applied Price"},"dcRate":{"type":"integer","format":"int32","description":"Discount Rate"},"dispCtgNo":{"type":"array","description":"Display Category No.","items":{"$ref":"#/components/schemas/SearchProductCateData"}},"dlexTypCd":{"type":"string","description":"Delivery Fee Type Code"},"payWayMeanCd":{"type":"string","description":"Payment Method Code Information"},"rservSaleYn":{"type":"string","description":"Reservation Sale Status"},"goodsRevCnt":{"type":"integer","format":"int32","description":"Product Review Count"},"goodsRevHlpfulCnt":{"type":"integer","format":"int32","description":"Product Review Helpful Count"},"goodsRevStarscrAvgVal":{"type":"integer","format":"int32","description":"Product Review Average Rating"},"wishListCnt":{"type":"string","description":"Wishlist Count"},"goodsDtlDesc":{"type":"string","description":"Product Detailed Description"},"sendGb":{"type":"string","description":"Transmission Type"},"langCd":{"type":"string","description":"Language Code"},"extraData":{"type":"string","description":"ExtraData"},"goodsRepImgPathNm":{"type":"string","description":"Product Main Image"},"trnfTextCont":{"type":"string","description":"Product Main Image Alt Text"},"iconJson":{"type":"string","description":"ICON Information"},"colorDataList":{"$ref":"#/components/schemas/SearchProductColorData","description":"Color List"},"iconList":{"type":"array","items":{"type":"string"}}}},"SearchProductCateData":{"type":"object","description":"Product Search Summary Info Search Result Category Info","properties":{"dispCtgNo":{"type":"string","description":"Display Category No."},"ctgFullPath":{"type":"string","description":"Full Category Path"},"ctgFullPathNm":{"type":"string","description":"Full Category Path Name"},"siteNo":{"type":"string","description":"Site No."},"siteNm":{"type":"string","description":"Site Name"},"dpmlNo":{"type":"string","description":"Mall No."},"lrgCtgNm":{"type":"string","description":"Large Category Name"},"lrgCtgNo":{"type":"string","description":"Large Category No."}}},"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":"Large Category Name"},"lrgCtgNo":{"type":"string","description":"Large Category No."},"count":{"type":"integer","format":"int32","description":"Large Category Grouping Count"},"subCtgGrpData":{"type":"array","description":"Medium Category Info","items":{"$ref":"#/components/schemas/SearchSubCategoryData"}}}},"SearchSubCategoryData":{"type":"object","properties":{"subCtgNm":{"type":"string","description":"Sub-Category Name"},"subCtgNo":{"type":"string","description":"Sub-Category No."},"count":{"type":"integer","format":"int32","description":"Sub-Category Grouping Count"},"subCtgGrpData":{"description":"Sub-Category Info"}}}}},"paths":{"/v1/search/product-semantic":{"get":{"tags":["Product Search"],"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"}}}}}}}}}
```
## Popular Search Terms
> \## Function Description\
> \* Retrieves the top 10 most searched keywords from the past 24 hours until now.\
> \---\
> \## Detailed Description\
> \* Called to show popular search terms on the search page.\
> \* This feature does not require any parameters.\
> \* Can be configured so that clicking a searched keyword searches using that keyword.\
> \---\
> \## Revision History\
> \* Release v1.04\_231120 : Added search page popular search terms, newly added search page popular search terms\
> \* Release v1.05\_240621 : Added popular search term ranking change
```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":"Search Basic Request","properties":{"searchWord":{"type":"string","description":"Search Term"},"langCd":{"type":"string","description":"Multilingual Code"},"siteNo":{"type":"string","description":"Site No."},"sort":{"type":"string","description":"Sort Type Code"},"sortField":{"type":"string","description":"Sort Target Item"},"size":{"type":"string","description":"Items Displayed per Page"},"from":{"type":"string","description":"Page Start Point"},"filters":{"type":"string","description":"Filter Value"},"filter":{"type":"string","description":"Filter Value"},"minPrc":{"type":"integer","format":"int32","description":"Minimum Price"},"maxPrc":{"type":"integer","format":"int32","description":"Maximum Price"},"ctgNo":{"type":"string","description":"Category Store No."},"vector":{"type":"array","description":"Vector Data","items":{"type":"string"}},"special":{"type":"string","description":"Special Search"}}},"SearchPopularKeywords":{"type":"object","properties":{"keyword":{"type":"string","description":"Keyword"},"changeType":{"type":"integer","format":"int32","description":"Popularity Ranking Change"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/search/popularKeword":{"get":{"tags":["Product Search"],"summary":"Popular Search Terms","description":"## Function Description\n* Retrieves the top 10 most searched keywords from the past 24 hours until now.\n---\n## Detailed Description\n* Called to show popular search terms on the search page.\n* This feature does not require any parameters.\n* Can be configured so that clicking a searched keyword searches using that keyword.\n---\n## Revision History\n* Release v1.04_231120 : Added search page popular search terms, newly added search page popular search terms\n* Release v1.05_240621 : Added popular search term ranking change\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":"Popular Search Terms Inquiry Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/SearchPopularKeywords"}}}},"900":{"description":"Popular Search Terms Inquiry Failure","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```