> 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-5.md).

# 검색창 마크업 관리

검색창에 노출되는 마크업 단어를 효율적으로 관리하여 사용자에게 더 적합한 마크업을 제공합니다. 최근 수정 내용이 FO 검색창에 반영되어 검색 페이지 진입 시 더 유용한 검색어로 유도할 수 있습니다.

***

## 주요 기능

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

## 프로세스 정의

<figure><img src="/files/w0a7iIGAmQZtTMIpDHoj" 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="141.22216796875">API</th><th width="367.666748046875">설명</th><th width="92.4444580078125">Server</th><th width="89.111083984375">메소드</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=%EA%B2%80%EC%83%89%EC%B0%BD%20%EB%A7%88%ED%81%AC%EC%97%85%20%EA%B4%80%EB%A6%AC&#x26;path=modifySearchMarkupUseYn">🔗API 확인하기 ></a></td></tr><tr><td>검색창 마크업 수정</td><td>검색창 마크업 관리 페이지에서 검색창 마크업을 수정합니다.</td><td>BO</td><td>PUT</td><td><a href="https://apibo.x2bee.com/content?bo=goods&#x26;depth=%EA%B2%80%EC%83%89%EC%B0%BD%20%EB%A7%88%ED%81%AC%EC%97%85%20%EA%B4%80%EB%A6%AC&#x26;path=modifySearchMarkupInfo">🔗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=%EA%B2%80%EC%83%89%EC%B0%BD%20%EB%A7%88%ED%81%AC%EC%97%85%20%EA%B4%80%EB%A6%AC&#x26;path=registSearchMarkupMultiLang">🔗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=%EA%B2%80%EC%83%89%EC%B0%BD%20%EB%A7%88%ED%81%AC%EC%97%85%20%EA%B4%80%EB%A6%AC&#x26;path=registSearchMarkupInfo">🔗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=%EA%B2%80%EC%83%89%EC%B0%BD%20%EB%A7%88%ED%81%AC%EC%97%85%20%EA%B4%80%EB%A6%AC&#x26;path=getSearchMarkupList">🔗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=%EA%B2%80%EC%83%89%EC%B0%BD%20%EB%A7%88%ED%81%AC%EC%97%85%20%EA%B4%80%EB%A6%AC&#x26;path=getSearchMarkupListCount">🔗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=%EA%B2%80%EC%83%89%EC%B0%BD%20%EB%A7%88%ED%81%AC%EC%97%85%20%EA%B4%80%EB%A6%AC&#x26;path=getSearchMarkupInfo">🔗API 확인하기 ></a></td></tr></tbody></table>