February 2026

🚀Introducing v1.1.0

Faster Beacons • New Endpoints • Cleaner Data⚡️

What’s under the hood? Significant improvements to the Searchspring API ecosystem. We’ve modernized beacon tracking and expanded response data to give you more control with less effort.

🚨Major Updates🚨

🎉 New Beacon API - Beacon Tracking 2.0

Meet Beacon API v2, a ground-up modernization of our tracking system. By replacing the legacy Beacon and IntelliSuggest implementations, we’ve cleared the way for a more robust, streamlined architecture.

💡What's New

Simplified Event Structure - Streamlined beacon events with clear, consistent schemas
Better Developer Experience - Comprehensive OpenAPI specification with examples and API validation of payloads
Shopper Platform Events - Core e-commerce activities outside of search or recommendations
- cart/add - When shopper has added a product to the cart from a product detail page (PDP)
- cart/remove - When a product is removed from the cart
- order/transaction - When a shopper has completed an order transaction
- product/pageview - When a shopper has navigated to a product detail page (PDP)
- shopper/login - When a shopper has logged into their account
Enhanced Tracking Events - Four core event types across all services:
- render - When results are requested and displayed
- impression - When results come into the shopper's view
- clickthrough - When a shopper clicks on a result
- addtocart - When a shopper adds a product to cart (Quick Add feature)

🔌Service Coverage

Beacon 2.0 tracking is now available for:

Autocomplete - Track suggest and product recommendations from autocomplete
Search - Monitor search result interactions and conversions
Category - Dedicated tracking for category page results
Recommendations - Track personalized recommendation engagement

✍️Documentation Updates

New: Beacon API v2 OpenAPI Specification
Updated: API Integration Checklist - Now includes beacon tracking requirements

🆕 New Features & Enhancements

🆔Response ID Field

Every API response now includes a responseId - a unique identifier that connects API responses with beacon tracking events.

🎯What this Enables

Accurate attribution of user interactions to specific search results
Better analytics and reporting capabilities
Improved tracking accuracy across the customer journey

🛠️APIs Updated:

📂 New Category API Endpoint

We have introduced a dedicated Category API endpoint separate from the Search API, providing:

Differentiated search vs. category reporting
A Category-specific endpoint: /api/search/category.json
Required bgfilter parameter for category filtering

✍️Documentation:

Category API Specification
Category Result Pages

🗑️ Deprecated & Removed

🧹Legacy Documentation Removed

The following legacy documentation has been removed in favor of current API implementations:

🗄️Legacy API Documentation:

Legacy Recommendations API Request
Legacy Recommendations API Response
Legacy Suggest API Request
Legacy Suggest API Response

📈Legacy Tracking:

Legacy Beacon API (1.0)
IntelliSuggest Tracking (replaced by Beacon 2.0 and Beacon.js --- documentation coming soon!)

📞 Support

Questions about these updates? Reach out to:

Your Searchspring Point of Contact
Searchspring Support

For technical questions, please reference this version (v1.1.0) and the specific API or feature you're working with.