> 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/back-office-api/goods-bo-api/undefined-2.md).

# 추천검색어 관리

## 추천검색어/추천검색어 다국어 수정

> \## 기능설명\
> \* 추천검색어 페이지에서 추천검색어/추천검색어 다국어 내용을 수정합니다.\
> \---\
> \## 상세설명\
> \* 추천검색어/추천검색어의 다국어 내용을 수정합니다.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"RecomSchWrdInfoRequest":{"type":"object","description":"추천검색어 정보 Request","properties":{"recomSchWrdSeq":{"type":"string","description":"추천검색어순번(PK)"},"aplyStrDtm":{"type":"string","format":"date-time","description":"적용시작일시"},"aplyEndDtm":{"type":"string","format":"date-time","description":"적용종료일시"},"useYn":{"type":"string","description":"사용여부"},"sortSeq":{"type":"integer","format":"int32","description":"노출순서"},"recomSchWrd":{"type":"string","description":"추천검색어"},"mlRecomSchWrd":{"type":"string","description":"영문 추천검색어"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/goods/recomSchWrdMgmtApi/modifyRecomSchWrdInfo":{"put":{"tags":["추천검색어 관리"],"summary":"추천검색어/추천검색어 다국어 수정","description":"## 기능설명\n* 추천검색어 페이지에서 추천검색어/추천검색어 다국어 내용을 수정합니다.\n---\n## 상세설명\n* 추천검색어/추천검색어의 다국어 내용을 수정합니다.\n","operationId":"modifyRecomSchWrdInfo","parameters":[{"name":"request","in":"query","description":"추천검색어/추천검색어 다국어 수정 Request","schema":{"$ref":"#/components/schemas/RecomSchWrdInfoRequest"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecomSchWrdInfoRequest"}}},"required":true},"responses":{"200":{"description":"추천검색어/추천검색어 다국어 수정 성공","content":{"*/*":{"schema":{"type":"string"}}}},"900":{"description":"추천검색어/추천검색어 다국어 수정 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```

## 추천검색어 다국어 등록

> \## 기능설명\
> \* 추천검색어 페이지에서 추천검색어 다국어를 등록합니다.\
> \---\
> \## 상세설명\
> \* 추천검색어 다국어를 등록합니다.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"RecomSchWrdInfoRequest":{"type":"object","description":"추천검색어 정보 Request","properties":{"recomSchWrdSeq":{"type":"string","description":"추천검색어순번(PK)"},"aplyStrDtm":{"type":"string","format":"date-time","description":"적용시작일시"},"aplyEndDtm":{"type":"string","format":"date-time","description":"적용종료일시"},"useYn":{"type":"string","description":"사용여부"},"sortSeq":{"type":"integer","format":"int32","description":"노출순서"},"recomSchWrd":{"type":"string","description":"추천검색어"},"mlRecomSchWrd":{"type":"string","description":"영문 추천검색어"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/goods/recomSchWrdMgmtApi/registerRecomSchWrdMultiLangInfo":{"post":{"tags":["추천검색어 관리"],"summary":"추천검색어 다국어 등록","description":"## 기능설명\n* 추천검색어 페이지에서 추천검색어 다국어를 등록합니다.\n---\n## 상세설명\n* 추천검색어 다국어를 등록합니다.\n","operationId":"registerRecomSchWrdMultiLangInfo","parameters":[{"name":"request","in":"query","description":"추천검색어 다국어 등록 Request","schema":{"$ref":"#/components/schemas/RecomSchWrdInfoRequest"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecomSchWrdInfoRequest"}}},"required":true},"responses":{"200":{"description":"추천검색어 다국어 등록 성공","content":{"*/*":{"schema":{"type":"string"}}}},"900":{"description":"추천검색어 다국어 등록 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```

## 추천검색어 등록

> \## 기능설명\
> \* 추천검색어 페이지에서 추천검색어를 등록합니다.\
> \---\
> \## 상세설명\
> \* 추천검색어를 신규 등록합니다.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"RecomSchWrdInfoRequest":{"type":"object","description":"추천검색어 정보 Request","properties":{"recomSchWrdSeq":{"type":"string","description":"추천검색어순번(PK)"},"aplyStrDtm":{"type":"string","format":"date-time","description":"적용시작일시"},"aplyEndDtm":{"type":"string","format":"date-time","description":"적용종료일시"},"useYn":{"type":"string","description":"사용여부"},"sortSeq":{"type":"integer","format":"int32","description":"노출순서"},"recomSchWrd":{"type":"string","description":"추천검색어"},"mlRecomSchWrd":{"type":"string","description":"영문 추천검색어"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/goods/recomSchWrdMgmtApi/registerRecomSchWrdInfo":{"post":{"tags":["추천검색어 관리"],"summary":"추천검색어 등록","description":"## 기능설명\n* 추천검색어 페이지에서 추천검색어를 등록합니다.\n---\n## 상세설명\n* 추천검색어를 신규 등록합니다.\n","operationId":"registerRecomSchWrdInfo","parameters":[{"name":"request","in":"query","description":"추천검색어 등록 Request","schema":{"$ref":"#/components/schemas/RecomSchWrdInfoRequest"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecomSchWrdInfoRequest"}}},"required":true},"responses":{"200":{"description":"추천검색어 등록 성공","content":{"*/*":{"schema":{"type":"string"}}}},"900":{"description":"추천검색어 등록 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```

## 추천검색어 그리드 수정

> \## 기능설명\
> \* 추천검색어 페이지에서 추천검색어 그리드 수정내용을 저장합니다.\
> \---\
> \## 상세설명\
> \* 추천검색어 그리드의 수정사항을 저장합니다.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"RealGridCUDRequestRecomSchWrdInfoRequest":{"type":"object","properties":{"all":{"type":"array","items":{"$ref":"#/components/schemas/RecomSchWrdInfoRequest"}},"create":{"type":"array","items":{"$ref":"#/components/schemas/RecomSchWrdInfoRequest"}},"update":{"type":"array","items":{"$ref":"#/components/schemas/RecomSchWrdInfoRequest"}},"delete":{"type":"array","items":{"$ref":"#/components/schemas/RecomSchWrdInfoRequest"}}}},"RecomSchWrdInfoRequest":{"type":"object","description":"추천검색어 정보 Request","properties":{"recomSchWrdSeq":{"type":"string","description":"추천검색어순번(PK)"},"aplyStrDtm":{"type":"string","format":"date-time","description":"적용시작일시"},"aplyEndDtm":{"type":"string","format":"date-time","description":"적용종료일시"},"useYn":{"type":"string","description":"사용여부"},"sortSeq":{"type":"integer","format":"int32","description":"노출순서"},"recomSchWrd":{"type":"string","description":"추천검색어"},"mlRecomSchWrd":{"type":"string","description":"영문 추천검색어"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/goods/recomSchWrdMgmtApi/modifyRecomSchWrdGrid":{"post":{"tags":["추천검색어 관리"],"summary":"추천검색어 그리드 수정","description":"## 기능설명\n* 추천검색어 페이지에서 추천검색어 그리드 수정내용을 저장합니다.\n---\n## 상세설명\n* 추천검색어 그리드의 수정사항을 저장합니다.\n","operationId":"modifyRecomSchWrdGrid","parameters":[{"name":"request","in":"query","description":"추천검색어 목록 수정 Request","schema":{"type":"RecomSchWrdInfoRequest"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RealGridCUDRequestRecomSchWrdInfoRequest"}}},"required":true},"responses":{"200":{"description":"추천검색어 그리드 수정 성공","content":{"*/*":{"schema":{"type":"string"}}}},"900":{"description":"추천검색어 그리드 수정 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```

## 추천검색어의 등록된 다국어 수 조회

> \## 기능설명\
> \* 추천검색어 페이지에서 추천검색어의 등록된 다국어 수를 조회합니다.\
> \---\
> \## 상세설명\
> \* 해당 API의 총건수의 결과 값은 추천검색어가 신규등록인지 수정인지 구분하기 위하여 사용됩니다.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"RecomSchWrdInfoRequest":{"type":"object","description":"추천검색어 정보 Request","properties":{"recomSchWrdSeq":{"type":"string","description":"추천검색어순번(PK)"},"aplyStrDtm":{"type":"string","format":"date-time","description":"적용시작일시"},"aplyEndDtm":{"type":"string","format":"date-time","description":"적용종료일시"},"useYn":{"type":"string","description":"사용여부"},"sortSeq":{"type":"integer","format":"int32","description":"노출순서"},"recomSchWrd":{"type":"string","description":"추천검색어"},"mlRecomSchWrd":{"type":"string","description":"영문 추천검색어"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/goods/recomSchWrdMgmtApi/getRecomSchWrdMultiLangCount":{"get":{"tags":["추천검색어 관리"],"summary":"추천검색어의 등록된 다국어 수 조회","description":"## 기능설명\n* 추천검색어 페이지에서 추천검색어의 등록된 다국어 수를 조회합니다.\n---\n## 상세설명\n* 해당 API의 총건수의 결과 값은 추천검색어가 신규등록인지 수정인지 구분하기 위하여 사용됩니다.\n","operationId":"getRecomSchWrdMultiLangCount","parameters":[{"name":"request","in":"query","description":"추천검색어의 등록된 다국어 수 조회 Request","required":true,"schema":{"$ref":"#/components/schemas/RecomSchWrdInfoRequest"}}],"responses":{"200":{"description":"추천검색어의 등록된 다국어 수 조회 성공","content":{"*/*":{"schema":{"type":"integer","format":"int32"}}}},"900":{"description":"추천검색어의 등록된 다국어 수 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```

## 추천검색어 목록

> \## 기능설명\
> \* 추천검색어 페이지에서 추천검색어 목록을 조회합니다.\
> \---\
> \## 상세설명\
> \* 입력한 사용여부, 추천검색어에 해당하는 추천검색어를 조회합니다.\
> \* 최근 적용시작일시 순으로 조회합니다.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"RecomSchWrdRequest":{"type":"object","description":"추천검색어 Request","properties":{"siteNo":{"type":"string","description":"사이트"},"dataLangCd":{"type":"string","description":"다국어 등록 언어코드"},"aplyStrDtm":{"type":"string","format":"date-time","description":"적용시작일시"},"aplyEndDtm":{"type":"string","format":"date-time","description":"적용종료일시"},"useYn":{"type":"string","description":"사용여부"},"recomSchWrd":{"type":"string","description":"추천검색어"},"dateSelect":{"type":"string","description":"날짜 버튼"},"recomSchWrdSeq":{"type":"string","description":"추천검색어순번(PK)"}}},"RecomSchWrdResponse":{"type":"object","description":"추천검색어 Response","properties":{"siteNo":{"type":"string","description":"사이트번호"},"sysRegDtm":{"type":"string","format":"date-time","description":"등록일시"},"sysRegId":{"type":"string","description":"등록자"},"siteNm":{"type":"string","description":"사이트명"},"recomSchWrdSeq":{"type":"string","description":"추천검색어순번"},"recomSchWrd":{"type":"string","description":"추천검색어"},"mlRecomSchWrd":{"type":"string","description":"다국어 추천검색어"},"useYn":{"type":"string","description":"사용여부"},"sortSeq":{"type":"string","description":"노출순서"},"aplyStrDtm":{"type":"string","format":"date-time","description":"적용시작일시"},"aplyEndDtm":{"type":"string","format":"date-time","description":"적용종료일시"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/goods/recomSchWrdMgmtApi/getRecomSchWrdList":{"get":{"tags":["추천검색어 관리"],"summary":"추천검색어 목록","description":"## 기능설명\n* 추천검색어 페이지에서 추천검색어 목록을 조회합니다.\n---\n## 상세설명\n* 입력한 사용여부, 추천검색어에 해당하는 추천검색어를 조회합니다.\n* 최근 적용시작일시 순으로 조회합니다.\n","operationId":"getRecomSchWrdList","parameters":[{"name":"recomSchWrdRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/RecomSchWrdRequest"}},{"name":"request","in":"query","description":"추천검색어 Request","schema":{"$ref":"#/components/schemas/RecomSchWrdRequest"}}],"responses":{"200":{"description":"추천검색어 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RecomSchWrdResponse"}}}},"900":{"description":"추천검색어 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```

## 추천검색어 상세조회

> \## 기능설명\
> \* 추천검색어 페이지에서 추천검색어의 상세내용을 조회합니다.\
> \---\
> \## 상세설명\
> \* 해당추천검색어의 상세내용을 조회합니다.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"RecomSchWrdRequest":{"type":"object","description":"추천검색어 Request","properties":{"siteNo":{"type":"string","description":"사이트"},"dataLangCd":{"type":"string","description":"다국어 등록 언어코드"},"aplyStrDtm":{"type":"string","format":"date-time","description":"적용시작일시"},"aplyEndDtm":{"type":"string","format":"date-time","description":"적용종료일시"},"useYn":{"type":"string","description":"사용여부"},"recomSchWrd":{"type":"string","description":"추천검색어"},"dateSelect":{"type":"string","description":"날짜 버튼"},"recomSchWrdSeq":{"type":"string","description":"추천검색어순번(PK)"}}},"RecomSchWrdResponse":{"type":"object","description":"추천검색어 Response","properties":{"siteNo":{"type":"string","description":"사이트번호"},"sysRegDtm":{"type":"string","format":"date-time","description":"등록일시"},"sysRegId":{"type":"string","description":"등록자"},"siteNm":{"type":"string","description":"사이트명"},"recomSchWrdSeq":{"type":"string","description":"추천검색어순번"},"recomSchWrd":{"type":"string","description":"추천검색어"},"mlRecomSchWrd":{"type":"string","description":"다국어 추천검색어"},"useYn":{"type":"string","description":"사용여부"},"sortSeq":{"type":"string","description":"노출순서"},"aplyStrDtm":{"type":"string","format":"date-time","description":"적용시작일시"},"aplyEndDtm":{"type":"string","format":"date-time","description":"적용종료일시"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/goods/recomSchWrdMgmtApi/getRecomSchWrdInfo":{"get":{"tags":["추천검색어 관리"],"summary":"추천검색어 상세조회","description":"## 기능설명\n* 추천검색어 페이지에서 추천검색어의 상세내용을 조회합니다.\n---\n## 상세설명\n* 해당추천검색어의 상세내용을 조회합니다.\n","operationId":"getRecomSchWrdInfo","parameters":[{"name":"recomSchWrdRequest","in":"query","description":"추천검색어순번","required":true,"schema":{"$ref":"#/components/schemas/RecomSchWrdRequest"}}],"responses":{"200":{"description":"추천검색어 상세조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RecomSchWrdResponse"}}}},"900":{"description":"추천검색어 상세조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```