> 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/store-front/goods/undefined.md).

# 상품검색

쇼핑몰 검색 기능은 사용자가 빠르고 효과적으로 원하는 상품을 찾을 수 있는 핵심 기능입니다. 이 문서에서는 X2BEE의 검색 기능에 대한 핵심 기능, 프로세스 정의, API 목록, 및 용어 정의를 다룹니다.

* **키워드 검색**: 검색창을 통해 상품명, 브랜드, 특정 키워드를 입력하여 검색 결과 확인
* **자동 완성 기능**: 검색창에 텍스트 입력 시작 시 자동으로 나타나는 검색어 제안 기능
* **필터 및 정렬 옵션**: 가격, 브랜드, 평점 등 다양한 옵션을 사용해 검색 결과를 세부 조절

***

## 주요 기능

* 상품 목록, 카테고리, 브랜드, 연관 검색어 등 다양한 항목 검색 가능
* 이벤트 목록, 기획전 목록, 인기 검색어, 연관 추천 검색어 검색 가능
* 관리자가 마크업 및 추천 검색어를 통해 유도할 수 있는 목록 검색 가능

## 프로세스 정의

<figure><img src="https://2999922013-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXTxKSWMmuxEkop1pvuwe%2Fuploads%2FeJMRl6vuaarxsvXve8TJ%2F182419552.jpg?alt=media&amp;token=8ef41396-e194-4d27-849a-a8e9e9080122" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

### 검색 입력 단계

* 검색창: 사용자가 검색어를 입력하는 공간
* 자동 완성 및 제안: 사용자가 검색어를 입력하면 자동으로 완성되거나 관련된 검색어가 제시됨.
* 검색 버튼: 사용자가 검색을 시작하는 버튼
  {% endstep %}

{% step %}

### 서버 요청 단계

* API server: 검색 엔진에 검색 요청 및 데이터베이스 정보 조회
  {% endstep %}

{% step %}

### 검색 처리 단계

* 검색 엔진 알고리즘: 사용자의 검색어를 분석하고, 인덱싱 된 데이터베이스에서 관련 정보를 찾는 알고리즘
* 데이터 베이스: BO 작성 정보
  {% endstep %}

{% step %}

### 결과 제공 단계

* 검색 결과 리스트: 사용자의 검색어와 관련된 웹 페이지 및 문서의 목록
* 페이지 링크: 각 결과 항목을 클릭하면 해당 페이지로 이동
* 이미지 링크: 각 검색 결과의 이미지 링크
  {% endstep %}
  {% endstepper %}

## API 기능 목록

<table><thead><tr><th width="134.5555419921875">API</th><th width="356.3333740234375">설명</th><th width="98">Server</th><th width="90.2222900390625">메소드</th><th width="152">비</th></tr></thead><tbody><tr><td>상품 통합 검색</td><td>•키워드로 상품에 대한 통합 정보를 검색합니다. <br>•상품 목록, 카테고리 목록, 브랜드 목록, 연관 검색어 목록이 포함된 결과를 반환합니다.</td><td>Goods</td><td>POST</td><td><a href="http://api.x2bee.com/content?msa=goods&#x26;depth=%EC%83%81%ED%92%88%EA%B2%80%EC%83%89&#x26;path=seltSearchEngine">🔗API 확인하기></a></td></tr><tr><td>기획전 검색</td><td><p>•현재 키워드와 관련된 기획전 행사를 검색하는 기능입니다. </p><p>•기획전은 여러 언어를 지원합니다.</p></td><td>Goods</td><td>POST</td><td><a href="http://api.x2bee.com/content?msa=goods&#x26;depth=%EC%83%81%ED%92%88%EA%B2%80%EC%83%89&#x26;path=seltExhibiionList">🔗API 확인하기></a></td></tr><tr><td>이벤트 검색</td><td>•현재 키워드와 관련된 이벤트 행사를 검색하는 기능입니다.</td><td>Goods</td><td>POST</td><td><a href="http://api.x2bee.com/content?msa=goods&#x26;depth=%EC%83%81%ED%92%88%EA%B2%80%EC%83%89&#x26;path=seltEventList">🔗API 확인하기></a></td></tr><tr><td>추천 검색어</td><td><p>•검색어를 입력하면 연관된 추천 검색어를 보여줄 때 사용합니다. </p><p>•키워드 입력 시 실시간으로 연동하면 자동</p><p>완성과 동일한 기능으로 구현이 가능합니다.</p></td><td>Goods</td><td>GET</td><td><a href="http://api.x2bee.com/content?msa=goods&#x26;depth=%EC%83%81%ED%92%88%EA%B2%80%EC%83%89&#x26;path=seltRecommendationList">🔗API 확인하기></a></td></tr><tr><td>검색창 마크업 및 추천검색어</td><td><p>•추천 검색어, 마크업 검색어 중에서 가장 </p><p>최근에 수정된 내용을 제공합니다. </p><p>•제공된 내용은 검색 페이지 진입 시 검색창에 기본으로 노출하여 의도하는 상품이나 기획 </p><p>페이지로의 유인에 사용할 수 있습니다.</p></td><td>Goods</td><td>GET</td><td><a href="http://api.x2bee.com/content?msa=goods&#x26;depth=%EC%83%81%ED%92%88%EA%B2%80%EC%83%89&#x26;path=seltRecommendWord">🔗API 확인하기></a></td></tr><tr><td>상품 조건 검색</td><td><p>•검색 결과를 좀 더 세부적으로 조절하기 위해 가격, 브랜드, 평점 등 다양한 필터 및 정렬 </p><p>옵션을 사용할 수 있습니다. </p><p>•약속된 코드로 결과를 정렬시킬 수 있습니다.</p></td><td>Goods</td><td>GET</td><td><a href="http://api.x2bee.com/content?msa=goods&#x26;depth=%EC%83%81%ED%92%88%EA%B2%80%EC%83%89&#x26;path=seltSearchProduct">🔗API 확인하기></a></td></tr><tr><td>인기 검색어</td><td>•검색 페이지에서 인기 검색어를 보여줄 때 <br>호출합니다. <br>•현재부터 24시간 전까지 가장 많이 검색된 <br>키워드 목록 상위 10개를 제공합니다.</td><td>Goods</td><td>GET</td><td><a href="http://api.x2bee.com/content?msa=goods&#x26;depth=%EC%83%81%ED%92%88%EA%B2%80%EC%83%89&#x26;path=seltPopularWrdList">🔗API 확인하기></a></td></tr></tbody></table>

## 용어 정의

<table><thead><tr><th width="136.77783203125">용어 명칭</th><th>설명</th><th>비고</th></tr></thead><tbody><tr><td>검색 정렬 조건 (약속된 코드)</td><td>10:판매순, 20:낮은가격순, 30:높은가격순, 40:할인율순, 50:최신순, 60:상품평많은순</td><td>코드 값을 변경 할 경우 검색엔진도 <br>동일한 코드 값으로 수정 필요함</td></tr><tr><td>검색 필터 조건</td><td>카테고리, 브랜드, 구매제한나이, <br>배송비정책, 가격, 별점, 결제수단</td><td>필터조건을 추가로 구현할 경우 상품 <br>통합 검색 ( v1/search/search ) API에 기술 되어져 있는 파라미터 항목내에서 추가적용 가능</td></tr><tr><td>검색 창 마크업 및 추천 검색어 관리</td><td>- BO 상품 > 검색어관리 > 추천검색어<br>- BO 상품 > 검색어관리 > 마크업 검색어</td><td>추천검색어/마크업검색어 관리에서 <br>수정일자 기준으로 가장 최근1건이 <br>검색 입력창에 노출됨</td></tr></tbody></table>