Skip to content

Overview

When building a custom Smart Search integration that calls the Rebuy API directly — without using the Rebuy JS package — you are responsible for firing the analytics events that Rebuy JS would otherwise fire automatically. These events populate the Smart Search analytics dashboard and enable conversion tracking.

All events use the Rebuy Analytic 2.0 endpoints:

POST https://rebuyengine.com/api/v2/analytics/event
POST https://rebuyengine.com/api/v2/analytics/event/bulk

Use the bulk endpoint

A single search interaction can generate many events — session start, one per search result, filter events, and conversion events. Use the bulk endpoint to send multiple events in a single request (up to 100) rather than making individual calls for each event.

Using the Rebuy JS package?

If your integration uses the Rebuy JS package, these events fire automatically. This reference is for custom integrations that call the Rebuy API directly.

Quick View vs Results Page

Smart Search has two surfaces. Most events apply to both, but the payloads differ in a few key ways:

Aspect Quick View Results Page
Surface Instant search overlay Dedicated search results page
Type meta key "is-quick-view": true "is-results-page": true
Add to cart source "Quick View" "Search Result"
Search Term Changed event Yes No
Trigger Input debounce URL param or manual

Events

Event When it fires Quick View Results Page
Search Session Start Overlay opens or results page loads Yes Yes
User Searched User performs a search Yes Yes
Searched Product Viewed Once per product in results Yes Yes
Filter Type Applied User applies a filter (once per filter type) Yes Yes
Filter Value Applied Once per individual filter value Yes Yes
No Search Results Search returns zero products Yes Yes
Search Term Changed User changes search term after a previous search Yes —
Click to PDP User clicks a product to view its detail page Yes Yes
Add to Cart User adds a product to cart from search Yes Yes
See something that needs updating? Suggest an edit