> 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-api/main-and-full-menu/category.md).

# Category

Used to help customers effectively browse product categories and to provide category-related information. Category information registered in the X2BEE BO's display category menu and products mapped to categories can be displayed. Through this API, users can select the category they want and access the product list and information within that category.

***

{% columns %}
{% column %}

<p align="center"><strong>PC</strong></p>

<figure><img src="https://2999922013-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXTxKSWMmuxEkop1pvuwe%2Fuploads%2FjWndOxTNapjawZNU7skm%2Fimage-20240416-042519.png?alt=media&#x26;token=e1f54cbb-85ff-46eb-b148-7ddceb474cc4" alt="" width="375"><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}

<p align="center"><strong>Mobile</strong></p>

<figure><img src="https://2999922013-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXTxKSWMmuxEkop1pvuwe%2Fuploads%2FEUrd1ETGHYnNf9beq5lq%2Fimage-20240416-042627.png?alt=media&#x26;token=8810292e-1046-457f-bfc4-2b42f244a514" alt="" width="176"><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

***

## Category List <a href="#plus" id="plus"></a>

<div align="center"><img src="https://tech.x2bee.com/download/attachments/266109414/FO%20API%20%ED%99%9C%EC%9A%A9%ED%95%98%EA%B8%B0-%EC%B9%B4%ED%85%8C%EA%B3%A0%EB%A6%AC%20%EC%A0%95%EB%B3%B4.drawio.png" alt=""></div>

### 1. Look Up Category List <a href="#id-1" id="id-1"></a>

Provides hierarchically structured display category information.

* **Look up display category list (**[🔗View API >](https://api.x2bee.com/content?msa=display\&depth=%EC%A0%84%EC%8B%9C%EC%B9%B4%ED%85%8C%EA%B3%A0%EB%A6%AC\&path=getCategoryList))\
  Looks up the full display category information or the brand display category information.

```
GET /v1/displayCategory 
```

***

## Category Store <a href="#plus" id="plus"></a>

Clicking a desired category in the category list navigates to the linked display category store page.

The information and product display list of the linked category store may appear differently depending on the template.

<div align="center"><img src="https://tech.x2bee.com/download/attachments/266109414/FO%20API%20%ED%99%9C%EC%9A%A9%ED%95%98%EA%B8%B0-%EC%A0%84%EC%8B%9C%20%EC%B9%B4%ED%85%8C%EA%B3%A0%EB%A6%AC%20%EC%83%81%ED%92%88%EC%A0%84%EC%8B%9C.drawio.png" alt=""></div>

### 1. Look Up Category Store Information <a href="#id-1" id="id-1"></a>

You can call and look up the information for the store registered in that category.

* **Look up category store information (**[🔗View API >](https://api.x2bee.com/content?msa=display\&depth=%EC%A0%84%EC%8B%9C%EB%A7%A4%EC%9E%A5/getShopInfoByDispCtgNo))\
  Looks up the store information for that category.

```
GET /v1/shop/category/{dispCtgNo} 
```

### 2. Look Up Displayed Product List <a href="#id-2" id="id-2"></a>

Displays the products mapped to that category.

* **Look up displayed products (**[🔗View API >](https://api-goods.x2bee.com/api/goods/swagger-ui/index.html#/%EC%83%81%ED%92%88%EA%B2%80%EC%83%89/seltSearchProduct))\
  Looks up the list of products for that category, adding sort conditions, filter conditions, and more.

```
GET /v1/search/product 
```