The top search report shows how your top search feature is performing — how many users see and click top searches, how those clicks translate into browsing and purchasing behavior, and where searches return empty results. Use it to diagnose whether your top search configuration is working and to identify specific areas to improve.
View the report
In the left-side navigation pane, choose Report Statistics > Top search report. Select an application from the Application Name drop-down list and a model from the Model name drop-down list.
Click a metric category tab — Core metrics, Traffic metrics, Click metrics, or Guided search metrics — then set the date picker to the time period you want.
Data availability
Single-day view: The report displays data for the previous day by default. Use the date picker to select a different day.
Trend view: Line charts show metric trends for the last seven days by default. Click a metric's icon to display its line chart. Use the date picker to select a different period.
Data delay: After you upload behavioral data, the report reflects that data starting the next day (T+1).
Metric categories
OpenSearch provides four categories of metrics for top searches: core metrics, traffic metrics, click metrics, and guided search metrics.
Metrics that depend on user click behavior require the data collection feature to be enabled and behavioral data to be uploaded. Metrics that depend on the from_request_id, raw_query, or user_id fields require those fields to be set in your API requests or SDK calls.
Core metrics
Core metrics give you a combined view of top search traffic, engagement, and guided-search performance in one place.
| Metric | Definition | Calculation | Dependency |
|---|---|---|---|
| Hot search PV | Number of successful top search requests (page views, PV). Throttled or otherwise failed requests are excluded. | Counts each request that receives a success response | — |
| Hot search UV | Number of distinct users (unique visitors, UV) who received top search results. Failed requests and duplicate users are excluded. | Unique user_id values in successful requests | user_id in top search requests |
| Hot search request error times | Number of top search requests that returned an error (for example, due to throttling) | Counts each request that receives an error response | — |
| Hot search PV-CTR | Click-through rate (CTR) of top searches based on page views | Hot search IPV ÷ Hot search PV | raw_query and from_request_id in search requests |
| Hot search UV-CTR | CTR based on unique users | Hot search IPV_UV ÷ Hot search UV | raw_query and from_request_id in search requests; user_id in top search requests |
| Hot search TOP3 PV-CTR | CTR for the top three searches | Clicks on the top 3 searches ÷ Hot search PV | from_request_id in search requests |
| Guided search PV ratio | Share of all searches that originate from a top search click | Guided search PV ÷ Search PV | from_request_id in search requests |
| Guided search PV-CTR | CTR of searches that users triggered by clicking a top search. Measures item page view (IPV) rate for guided searches. | IPV of guided searches ÷ Guided search PV | raw_query and from_request_id in search requests; data collection feature; uploaded click behavioral data |
What these numbers tell you
A low Hot search PV-CTR or Hot search UV-CTR means users are seeing top search suggestions but not clicking them. Review whether your top search terms match actual user intent.
A high Hot search request error times count suggests throttling pressure. Consider increasing your top search quota or adjusting the configuration.
A low Guided search PV ratio means top searches are not driving a significant share of overall search traffic. Check whether top searches are prominently displayed.
A low Guided search PV-CTR indicates that searches triggered by top search clicks are returning results users do not find relevant. Review retrieval and ranking configuration for guided searches.
Traffic metrics
Traffic metrics focus on request volume and error rates for the top search feature itself.
| Metric | Definition | Calculation | Dependency |
|---|---|---|---|
| Hot search PV | Number of successful top search requests. Throttled or otherwise failed requests are excluded. | Counts each request that receives a success response | — |
| Hot search UV | Number of distinct users who received top search results. Each user is counted once. | Unique user_id values in successful requests | user_id in top search requests |
| Hot search request error times | Number of top search requests that returned an error | Counts each request that receives an error response | — |
| Hot search request error rate | Ratio of failed requests to all top search requests | Hot search request error times ÷ (Hot search PV + Hot search request error times) | — |
What these numbers tell you
A rising Hot search request error rate is a signal to adjust your top search configuration — for example, by increasing the number of available top searches or raising your quota.
Monitor Hot search UV alongside Hot search PV: a large gap between the two means some users are making many requests, which may indicate retry behavior caused by errors.
Click metrics
Click metrics measure how users interact with top search results after clicking a suggestion.
| Metric | Definition | Calculation | Dependency |
|---|---|---|---|
| Hot search IPV | Number of clicks on top searches | Counts each click on a top search | from_request_id in search requests |
| Hot search IPV_UV | Number of distinct users who clicked a top search. Each user is counted once. | Unique users among those who clicked top searches | raw_query and from_request_id in search requests; user_id in top search requests |
| Hot search PV-CTR | CTR of top searches | Hot search IPV ÷ Hot search PV | raw_query and from_request_id in search requests |
| Hot search UV-CTR | CTR based on unique users | Hot search IPV_UV ÷ Hot search UV | raw_query and from_request_id in search requests; user_id in top search requests |
| Hot search has clicked PV ratio | Ratio of top search requests whose results were clicked to all top search requests | Requests whose results were clicked ÷ Hot search PV | from_request_id in search requests |
| Hot search TOP1 PV-CTR | CTR for the top one search | Clicks on the #1 search ÷ Hot search PV | from_request_id in search requests |
| Hot search TOP3 PV-CTR | CTR for the top three searches | Clicks on the top 3 searches ÷ Hot search PV | from_request_id in search requests |
| Hot Search TOP5 PV-CTR | CTR for the top five searches | Clicks on the top 5 searches ÷ Hot search PV | from_request_id in search requests |
What these numbers tell you
Compare Hot search TOP1 PV-CTR, Hot search TOP3 PV-CTR, and Hot Search TOP5 PV-CTR together. A steep drop from TOP1 to TOP3 suggests users find only the first suggestion relevant; consider refreshing the #2 and #3 suggestions.
A low Hot search has clicked PV ratio means many users see top search results but none of them click. This is an early signal that top search content may be stale or misaligned with current user intent.
Click metrics require the
from_request_idfield in search requests. If all CTR values show as zero, verify that your integration passes this field.
Guided search metrics
Guided search metrics measure the downstream effect of top searches — what users do after they click a top search suggestion and run the resulting search.
| Metric | Definition | Calculation | Dependency |
|---|---|---|---|
| Guided search PV | Number of searches triggered by clicking a top search. Includes paging requests. | Counts each search initiated from a top search click | from_request_id in search requests |
| Guided search PV ratio | Share of all searches that originate from top search clicks | Guided search PV ÷ Search PV | from_request_id in search requests |
| Guided search UV | Number of distinct users who clicked a top search. Each user is counted once. | Unique users who triggered at least one guided search | user_id and from_request_id in search requests |
| Guided search UV ratio | Share of all top search users who clicked a top search suggestion | Guided search UV ÷ Search UV | user_id and from_request_id in search requests |
| Guided search no result rate | Ratio of guided searches that returned empty results | Guided searches with no results ÷ Guided search PV | from_request_id in search requests |
| Guided search PV-CTR | CTR of guided searches — the ratio of guided searches that led to an item page view | IPV of guided searches ÷ Guided search PV | raw_query and from_request_id in search requests; data collection feature; uploaded click behavioral data |
| Guided search has clicks on the percentage of PV | Ratio of guided searches whose results were clicked to all guided searches | Guided searches whose results were clicked ÷ Guided search PV | from_request_id in search requests; data collection feature; uploaded click event data |
| Guided search for GMV | Gross merchandise volume (GMV) from purchases guided by top searches | Sum of transaction amounts from top search-guided sessions | Data collection feature; uploaded purchase behavioral data (bhv_type = buy) |
| Guided search favorite conversion rate | Ratio of times when users add items to favorites from the results of top search-guided searches to all top search-guided searches | Favorites additions from guided searches ÷ Guided search PV | Data collection feature; uploaded favorites behavioral data (bhv_type = collect) |
| Guided search to the shopping cart conversion rate | Ratio of times when users add items to the shopping cart from the results of top search-guided searches to all top search-guided searches | Cart additions from guided searches ÷ Guided search PV | Data collection feature; uploaded cart behavioral data (bhv_type = cart) |
| Guided search like conversion rate | Ratio of times when users like items in the results of top search-guided searches to all top search-guided searches | Likes from guided searches ÷ Guided search PV | Data collection feature; uploaded like behavioral data (bhv_type = like) |
| Guided search review conversion rate | Ratio of times when users post comments on items in the results of top search-guided searches to all top search-guided searches | Comments from guided searches ÷ Guided search PV | Data collection feature; uploaded comment behavioral data (bhv_type = comment) |
What these numbers tell you
A high Guided search no result rate means top search suggestions are directing users to searches with no matching results. Update your top search terms to reflect terms that return results, or expand your search index to cover common top search queries.
A low Guided search PV-CTR or Guided search has clicks on the percentage of PV means the results returned after a top search click are not engaging. Review the retrieval and ranking configuration for those query terms.
Guided search for GMV, Guided search favorite conversion rate, Guided search to the shopping cart conversion rate, Guided search like conversion rate, and Guided search review conversion rate require behavioral data upload with the corresponding
bhv_typevalues. If these metrics show no data, verify that your data collection pipeline is uploading events with the correctbhv_typefield.