> 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-guide/back-office/goods-bo/undefined-8/undefined-4.md).

# 추천 검색어 관리

검색창에 노출되는 추천 검색어를 효율적으로 관리하는 기능을 제공합니다. 검색어를 등록하고 수정함으로써 사용자에게 더 적합한 추천 검색어를 제공하여 원하는 상품 또는 기획 페이지로 유도할 수 있습니다.

***

## 주요 기능

* **검색어 등록/수정**
  * 추천 검색어를 효율적으로 등록하고 필요에 따라 수정합니다.
  * 최근 수정된 검색어가 FO 검색창에 노출됩니다.
* **검색어 조회**
  * 기간, 사용 여부, 검색어를 기준으로 목록을 조회합니다.
* **검색어 우선순위 조절**
  * 검색창에 노출되는 추천 검색어의 우선순위를 조절합니다.
* **마크업 검색어 관리**
  * 마크업 검색어 중 최근 수정된 내용이 FO 검색창에 노출됩니다.

## 프로세스 정의

<figure><img src="/files/9aHkyRgay5rXQXULll6Y" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

### 목록 조회

추천 검색어 목록을 조회한다.
{% endstep %}

{% step %}

### 추천 검색어 수정

조회된 그리드에서 데이터를 직접 수정을 할 수 있다.
{% endstep %}

{% step %}

### 추천 검색어 등록/수정

조회된 내용에서 추천검색어 링크를 누르면 추천 검색어 등록 / 수정 팝업으로 진입한다.
{% endstep %}

{% step %}

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

조회된 내용에서 영문 추천검색어 링크를 누르면 다국어 추천 검색어 등록 / 수정 팝업으로 진입한다.
{% endstep %}

{% step %}

### 상세 조회

등록 / 수정 팝업 진입 시 기존에 등록된 내용을 상세 조회 한다.
{% endstep %}

{% step %}

### 수정

기존에 등록된 내용을 수정할 수 있다.
{% endstep %}

{% step %}

### 신규 등록

등록 버튼을 클릭하면 등록 / 수정 팝업 진입 후 신규로 내용을 등록할 수 있다.
{% endstep %}
{% endstepper %}

## API 기능 목록

<table><thead><tr><th width="215.666748046875">API</th><th width="285.2222900390625">설명</th><th width="92.4444580078125">Server</th><th width="92.4444580078125">메소드</th><th>비고</th></tr></thead><tbody><tr><td>추천검색어 / 추천검색어 다국어 수정</td><td>추천검색어 페이지에서 추천검색어 다국어 내용을 수정합니다.</td><td>BO</td><td>PUT</td><td><a href="https://apibo.x2bee.com/content?bo=goods&#x26;depth=%EC%B6%94%EC%B2%9C%EA%B2%80%EC%83%89%EC%96%B4%20%EA%B4%80%EB%A6%AC&#x26;path=modifyRecomSchWrdInfo">🔗API 확인하기 ></a></td></tr><tr><td>추천검색어 다국어 등록</td><td>추천검색어 페이지에서 추천검색어 다국어를 등록합니다.</td><td>BO</td><td>POST</td><td><a href="https://apibo.x2bee.com/content?bo=goods&#x26;depth=%EC%B6%94%EC%B2%9C%EA%B2%80%EC%83%89%EC%96%B4%20%EA%B4%80%EB%A6%AC&#x26;path=registerRecomSchWrdMultiLangInfo">🔗API 확인하기 ></a></td></tr><tr><td>추천검색어 등록</td><td>추천검색어 페이지에서 추천검색어를 등록합니다.</td><td>BO</td><td>POST</td><td><a href="https://apibo.x2bee.com/content?bo=goods&#x26;depth=%EC%B6%94%EC%B2%9C%EA%B2%80%EC%83%89%EC%96%B4%20%EA%B4%80%EB%A6%AC&#x26;path=registerRecomSchWrdInfo">🔗API 확인하기 ></a></td></tr><tr><td>추천검색어 그리드 수정</td><td>추천검색어 페이지에서 추천검색어 그리드 수정내용을 저장합니다.</td><td>BO</td><td>POST</td><td><a href="https://apibo.x2bee.com/content?bo=goods&#x26;depth=%EC%B6%94%EC%B2%9C%EA%B2%80%EC%83%89%EC%96%B4%20%EA%B4%80%EB%A6%AC&#x26;path=modifyRecomSchWrdGrid">🔗API 확인하기 ></a></td></tr><tr><td>추천검색어의 등록된 <br>다국어 수 조회</td><td>추천검색어 페이지에서 추천검색어의 등록된 다국어 수를 조회합니다.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=goods&#x26;depth=%EC%B6%94%EC%B2%9C%EA%B2%80%EC%83%89%EC%96%B4%20%EA%B4%80%EB%A6%AC&#x26;path=getRecomSchWrdMultiLangCount">🔗API 확인하기 ></a></td></tr><tr><td>추천검색어 목록</td><td>추천검색어 페이지에서 추천검색어 목록을 조회합니다.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=goods&#x26;depth=%EC%B6%94%EC%B2%9C%EA%B2%80%EC%83%89%EC%96%B4%20%EA%B4%80%EB%A6%AC&#x26;path=getRecomSchWrdList">🔗API 확인하기 ></a></td></tr><tr><td>추천검색어 상세조회</td><td>추천검색어 페이지에서 추천검색어의 상세내용을 조회합니다.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=goods&#x26;depth=%EC%B6%94%EC%B2%9C%EA%B2%80%EC%83%89%EC%96%B4%20%EA%B4%80%EB%A6%AC&#x26;path=getRecomSchWrdInfo">🔗API 확인하기 ></a></td></tr></tbody></table>

##