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

Ready to start learning Beacon 2.0? View the Tracking section under each feature module to learn more about the new endpoints, and start making requests! 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
New all feature modules with access to Beacon 2.0 will have a new Tracking section that highlights new endpoints, implementation tips, and offerings!
Updated: API Integration Checklist - Now includes beacon tracking requirements

📚Ready to Migrate? Check out our Migration Guide for step-by-step instructions on how to transition to Beacon 2.0 and upgrade your tracking implementation.

🆕 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:

Autocomplete API (autocomplete.json)
Search API (search.json)
Category API (category.json)
Finder API (finder.json)
Personalized Recommendations API (recommendations)

📂 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:

🗑️ 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.

What's new in our docs