> 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/api-guides-en/store-front/goods/product-search.md).

# Product Search

The shopping mall search feature is a core function that lets users quickly and effectively find the products they want. This document covers the core features, process definitions, API list, and terminology for X2BEE's search functionality.

* **Keyword Search**: Enter a product name, brand, or specific keyword in the search box to view the search results
* **Autocomplete**: A feature that automatically suggests search terms as soon as the user starts typing in the search box
* **Filter and Sort Options**: Fine-tune search results using various options such as price, brand, and rating

***

## Key Features

* Supports searching a variety of items, including product lists, categories, brands, and related search terms
* Supports searching event lists, exhibition lists, popular search terms, and related recommended search terms
* Supports searching lists that administrators can promote through markup and recommended search terms

## Process Definition

<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&#x26;token=8ef41396-e194-4d27-849a-a8e9e9080122" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

### Search Input Stage

* Search box: The space where users enter their search terms
* Autocomplete and suggestions: As the user types a search term, it is automatically completed or related terms are suggested.
* Search button: The button users select to start a search
  {% endstep %}

{% step %}

### Server Request Stage

* API server: Sends the search request to the search engine and queries the database for information
  {% endstep %}

{% step %}

### Search Processing Stage

* Search engine algorithm: The algorithm that analyzes the user's search term and finds relevant information in the indexed database
* Database: BO (Back Office)-authored information
  {% endstep %}

{% step %}

### Result Delivery Stage

* Search result list: A list of web pages and documents related to the user's search term
* Page link: Clicking each result item navigates to the corresponding page
* Image link: The image link for each search result
  {% endstep %}
  {% endstepper %}

## API Function List

<table><thead><tr><th width="134.5555419921875">API</th><th width="356.3333740234375">Description</th><th width="98">Server</th><th width="90.2222900390625">Method</th><th width="152">Notes</th></tr></thead><tbody><tr><td>Integrated Product Search</td><td>•Searches integrated product information by keyword.<br>•Returns results that include a product list, category list, brand list, and related search term list.</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">🔗View API ></a></td></tr><tr><td>Exhibition Search</td><td><p>•A feature that searches for exhibition events related to the current keyword.</p><p>•Exhibitions support multiple languages.</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">🔗View API ></a></td></tr><tr><td>Event Search</td><td>•A feature that searches for event promotions related to the current keyword.</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">🔗View API ></a></td></tr><tr><td>Recommended Search Terms</td><td><p>•Used to display related recommended search terms when a search term is entered.</p><p>•When linked in real time as keywords are typed, it</p><p>can be implemented with the same functionality as autocomplete.</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">🔗View API ></a></td></tr><tr><td>Search Box Markup and Recommended Search Term</td><td><p>•Provides the most recently modified content</p><p>among recommended search terms and markup search terms.</p><p>•The provided content is displayed by default in the search box when the search page is entered, and can be used to guide users toward an intended product or exhibition</p><p>page.</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">🔗View API ></a></td></tr><tr><td>Product Condition Search</td><td><p>•Various filter and sort</p><p>options such as price, brand, and rating can be used to fine-tune search results.</p><p>•Results can be sorted using predefined codes.</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">🔗View API ></a></td></tr><tr><td>Popular Search Terms</td><td>•Called to display popular search terms on the<br>search page.<br>•Provides the top 10 most-searched<br>keywords from the past 24 hours to the present.</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">🔗View API ></a></td></tr></tbody></table>

## Terminology

<table><thead><tr><th width="136.77783203125">Term</th><th>Description</th><th>Notes</th></tr></thead><tbody><tr><td>Search Sort Condition (Predefined Codes)</td><td>10: Best-selling, 20: Lowest Price, 30: Highest Price, 40: Highest Discount Rate, 50: Newest, 60: Most Reviews</td><td>If the code value is changed, the search engine must also be<br>updated with the same code value</td></tr><tr><td>Search Filter Condition</td><td>Category, Brand, Purchase Age Restriction,<br>Delivery Fee Policy, Price, Rating, Payment Method</td><td>When implementing additional filter conditions, they can be added within the parameter items described in the Integrated Product<br>Search ( v1/search/search ) API</td></tr><tr><td>Search Box Markup and Recommended Search Term Management</td><td>- BO Products > Search Term Management > Recommended Search Terms<br>- BO Products > Search Term Management > Markup Search Terms</td><td>In Recommended Search Term/Markup Search Term management,<br>the most recently modified item (based on modification date) is<br>displayed in the search input box</td></tr></tbody></table>