# 추천검색어 관리

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

> \## 기능설명\
> \* 추천검색어 페이지에서 추천검색어/추천검색어 다국어 내용을 수정합니다.\
> \---\
> \## 상세설명\
> \* 추천검색어/추천검색어의 다국어 내용을 수정합니다.<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"}}}}}}}}}
```


---

# Agent Instructions: Querying This Documentation

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

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

```
GET https://tech.x2bee.com/api/back-office-api/goods-bo-api/undefined-2.md?ask=<question>
```

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

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