Search Analytics
Search Analytics
Track query quality, top products, and zero-result trends for search optimization.
Audience: Search relevance and merchandising teams improving discovery performance.
Critical: Organization-level search analytics endpoints are under /api/v1/analytics/search/*; site-level operational query tooling is under /api/v1/sites/:siteId/search/analytics/* in Modules > Search.
Who This Page Is For
Use this page for KPI-level search diagnostics across one site or the full organization.
Quick Start (2-5 Minutes)
Get top search queries
Review query demand and click behavior.
GET /api/v1/analytics/search/top-queries?siteId=SITE_ID&days=30&limit=50Get top clicked products
Identify products driving engagement from search.
GET /api/v1/analytics/search/top-products?siteId=SITE_ID&days=30&limit=20Get zero-result trends
Measure missed intent and monitor improvements over time.
GET /api/v1/analytics/search/zero-results?siteId=SITE_ID&days=30&limit=100Prioritize remediation
Take highest-volume misses into zero-results resolution workflow.
Use /modules/search/zero-results operational endpoints.Correlate with funnel metrics
Tie query improvements to conversion movement.
Compare with /analytics/funnels/:siteId?steps=search_query,product_click,add_to_cart,purchase.Search analytics endpoints
GET /api/v1/analytics/search/top-queries
GET /api/v1/analytics/search/top-products
GET /api/v1/analytics/search/zero-resultsRequired Fields / Minimum Payload
| Field | Required | Type | Used by events | Description |
|---|---|---|---|---|
siteId | Optional | uuid | All endpoints | Scope to one site; omit for organization aggregate. |
days | Optional | number | All endpoints | Lookback window. |
limit | Optional | number | All endpoints | Maximum number of records returned. |
Event or Endpoint Decision Matrix
| Scenario | Use This | Why |
|---|---|---|
| Need demand and CTR signal by query | /analytics/search/top-queries | Primary query performance diagnostics. |
| Need product-level search click winners | /analytics/search/top-products | Supports merchandising decisions. |
| Need missed-intent visibility | /analytics/search/zero-results | Highlights search coverage gaps. |
| Need operational remediation action | /modules/search/zero-results endpoints | Supports resolve workflow with status tracking. |
| Need search-to-conversion context | /analytics/funnels/:siteId?steps=search_query,product_click,add_to_cart,purchase | Connects search behavior to downstream conversion. |
Common Errors and Fixes
Top queries list looks noisy
Cause: Limit too high without query normalization post-processing.
Fix: Use narrower limit and normalize query variants in downstream analysis.
Top products missing expected SKUs
Cause: Search click events not consistently emitted from UI.
Fix: Verify click instrumentation for all result card interactions.
Zero-results remains high despite fixes
Cause: Resolutions not applied to highest-impact terms or catalog still missing products.
Fix: Prioritize by occurrences and validate post-resolution behavior.
Org-level metrics hide site anomalies
Cause: siteId omitted when one-site issue is being investigated.
Fix: Always include siteId during incident triage.
Production Checklist
- Search KPI dashboards include top-queries, top-products, and zero-results together.Required
- siteId filters are used for site-specific incident analysis.Required
- Zero-result remediation backlog is tied to query volume.Required
- Search click instrumentation is validated regularly.Required
- Search funnel trend is checked after each major ranking change.Required