May 2026

🆕 Express Sync Indexing: New Update Endpoint

The Express Sync Indexing API now supports a dedicated Update operation, giving you a more efficient way to modify existing product records without replacing their entire contents.

💡 What's New

Partial Updates – Send only the unique identifier and the specific fields you want to change. All other existing data is left untouched.
New endpoint: POST /api/index/update.json – distinct from /upsert.json, which requires a full product record and replaces existing data entirely.

✍️ Documentation Updates

Updated: Express Sync Indexing API – Now includes the Update endpoint with request details, payload examples, and guidance on how Update and Upsert differ.

📡 Bundle Beacon Tracking Endpoints

Bundle recommendations now have their own dedicated Beacon 2.0 tracking endpoints, separate from the standard /recommendations/ path. If you're rendering personalized bundle sets, you'll need to use these new endpoints to ensure accurate attribution and reporting.

💡 What's New

Dedicated /bundles/ path – Four new endpoints mirror the standard recommendation event flow but route bundle interactions independently for cleaner analytics.
- POST /{siteId}/bundles/render – When bundle results are requested and rendered on the page
- POST /{siteId}/bundles/impression – When bundle items scroll into the shopper's viewport
- POST /{siteId}/bundles/clickthrough – When a shopper clicks a bundle item to view its PDP
- POST /{siteId}/bundles/addtocart – When a shopper adds a bundle item via Quick Add to Cart

✍️ Documentation Updates

Updated: Recommendations Tracking Overview – Now includes a full Bundle Tracking section with endpoint details, event flow, and payload examples for all four bundle events.
New: Bundles Render – OpenAPI specification for the bundle render endpoint.
New: Bundles Impression – OpenAPI specification for the bundle impression endpoint.
New: Bundles Clickthrough – OpenAPI specification for the bundle clickthrough endpoint.
New: Bundles Add to Cart – OpenAPI specification for the bundle add to cart endpoint.

April 2026

📖 API Guides Section

We’ve reorganized our documentation to help you build faster! We just launched a dedicated Guides section in the API docs, moving beyond endpoint references to provide deep-dive tutorials and strategic migration paths.

Highlights include:

Libraries & Migration: A new tab for all SDK resources and versioning guides.
Platform Specifics: Detailed writeups for Snap SDK, Shopify Web Pixel, and Beacon.js.
New Migration Path: A specialized guide for transitioning from Searchspring to Athos.

ℹ️ Navigation Tip:

To keep things stable during this rollout, the Beacon.js and Beacon Migration guides will temporarily appear in both the new Guides tab and the API Integration Essentials section.

We’ll eventually move these exclusively to the Guides tab, but we’re keeping them in both spots for now to ensure all active bookmarks and links continue to work.

✍️Documentation Updates

Browse the new Guides section here →

February 2026

🏷️ The Evolution: Searchspring is now Athos Commerce

We are thrilled to officially announce our rebranding to Athos Commerce. Along with our new look, we are streamlining our developer experience by updating all API endpoints to reflect our new identity.

New Base URLs: All legacy searchspring.io endpoints are being transitioned to athoscommerce.net.
Product Evolution: You’ll notice IntelliSuggest and legacy terms have been retired in favor of the Athos Beacon ecosystem.

🚨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!
New view our Beacon.js library to skip the manual API handling with your new beaconing system.
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.

🎁 Expanded Bundle Recommendation Types

We have significantly upgraded our Personalized Recommendations suite with the introduction of advanced Bundle Profiles. This expansion moves beyond standard cross-selling to support a variety of "Shop the Look" and "Complete the Set" logic types across the entire storefront.

💡 What's New

Intelligent Seed Detection – The API now identifies the "Lead" item in a bundle using the bundleSeed: true tag, allowing for programmatically distinct styling in your UI.
Logic-Driven Diversity – Four new bundle categories to power every part of the shopper journey:
- Cross-Sell (PDP) – Standard product-to-product complementary logic.
- Cart Cross-Sell – Analyzes the entire cart to find optimal add-ons (with automatic duplicate filtering).
- Trending (Site/Category/Brand) – Pre-packaged bundles based on high-level site or category performance.
- Custom Bundles – Fully flexible sets driven by your specific AMC boost rules and filters.

🔌 Service Coverage

The new Bundle logic is available via the dedicated Personalization endpoint:

✍️ Documentation Updates

New: Bundle Logic Overview – A deep dive into seeded vs. non-seeded behaviors and implementation requirements.
Updated: Recommendations Tracking – Now includes specific instructions for sending addtocart beacons for bundle conversions.

🆕 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: /v1/category
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 Athos Point of Contact
Athos Support

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