> 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/back-office/goods-bo/undefined/search-ranking-management.md).

# Search Ranking Management

Provides functionality to set the ranking priority (weight grade) for each indexed attribute in order to adjust the exposure ranking of search results when a specific search term is queried. By selecting attributes and assigning a ranking priority for the product, promotion, and event indexes, the search engine reflects the weight for that attribute when determining the display order.

***

## Key Features

* **Ranking Policy List Lookup**
  * You can look up registered ranking policies by site, ranking criteria (index), ranking priority, and use status conditions.
* **Ranking Policy Registration/Modification/Deletion**
  * You can add, modify, and delete rows directly in the list grid, and apply them in bulk with the save button. (No separate popup)
* **Ranking Priority Grade Assignment**
  * The weight for each attribute is selected as a ranking priority grade (common code PR073) rather than entered as a number.
* **Duplicate Attribute Prevention**
  * Only one instance of the same ranking attribute can be registered for the same site, and duplication is validated upon registration.

## Process Definition

<figure><img src="https://2999922013-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXTxKSWMmuxEkop1pvuwe%2Fuploads%2Fv40Z2dkLn4eeqsPswqDF%2F12-%EA%B2%80%EC%83%89%EB%9E%AD%ED%82%B9-%ED%94%84%EB%A1%9C%EC%84%B8%EC%8A%A4%EB%8B%A4%EC%9D%B4%EC%96%B4%EA%B7%B8%EB%9E%A8.png?alt=media&#x26;token=836d6421-0284-4f23-8639-4cda94fce34f" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

### Search Ranking Management

On the Products > Search Term Management > Search Ranking Management screen, look up the list of ranking policies.
{% endstep %}

{% step %}

### Grid Row Editing

Use the register button to add a new row, or modify the ranking priority/use status of an existing row. When registering a new row, duplication of the attribute within the same site is validated.
{% endstep %}

{% step %}

### API Server Call

When the save button is clicked, the additions/modifications/deletions are saved in bulk. (Lookup: Ranking list lookup / Save: Ranking information registration and modification / Validation: Attribute duplication check)
{% endstep %}
{% endstepper %}

## API Function List

<table><thead><tr><th width="109.111083984375">API</th><th width="330.111083984375">Description</th><th width="96.8887939453125">Server</th><th width="95.7777099609375">Method</th><th>Remarks</th></tr></thead><tbody><tr><td>Ranking Information Registration and Modification</td><td>This is an API for registering and modifying ranking information.</td><td>BO</td><td>POST</td><td><a href="https://apibo.x2bee.com/content?bo=goods&#x26;depth=%EB%9E%AD%ED%82%B9%20%EA%B4%80%EB%A6%AC&#x26;path=saveRankTypeList">🔗View API ></a></td></tr><tr><td>Ranking List Lookup</td><td>This is an API for looking up the list of ranking information.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=goods&#x26;depth=%EB%9E%AD%ED%82%B9%20%EA%B4%80%EB%A6%AC&#x26;path=getRankList">🔗View API ></a></td></tr><tr><td>Attribute Duplication Check</td><td>This is an API for checking whether the same attribute is already registered for the same site.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=goods&#x26;depth=%EB%9E%AD%ED%82%B9%20%EA%B4%80%EB%A6%AC&#x26;path=checkDuplicatedAttribute">🔗View API ></a></td></tr></tbody></table>

## Terminology

<table><thead><tr><th width="129.5555419921875">Term</th><th>Description</th><th data-hidden></th></tr></thead><tbody><tr><td>Ranking Criteria (Index)</td><td>Managed under common code PR044 (Product, Promotion, Event)</td><td></td></tr><tr><td>Ranking Attribute</td><td>Managed under common code PR045 — the selectable attributes differ by index (product name, wishlist count, discount rate, etc.)</td><td></td></tr><tr><td>Ranking Priority</td><td>Managed under common code PR073 — weight grade (Normal, Very High, etc.). Converted to a weight value by grade and applied when saved</td><td></td></tr></tbody></table>

## User Configuration Screen

<figure><img src="https://2999922013-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXTxKSWMmuxEkop1pvuwe%2Fuploads%2F7wps8gZrPA8T7PlTnofe%2F08-%EA%B2%80%EC%83%89%EB%9E%AD%ED%82%B9%EA%B4%80%EB%A6%AC-%ED%98%84%ED%96%89.png?alt=media&#x26;token=c460aa71-73ad-42cf-932c-3ca34e64fd55" alt=""><figcaption></figcaption></figure>