Guides
  1. Getting Started

What's New in our Docs

Stay ahead of the curve! Your hub for all the latest Athos features and fixes, and our brand evolution!

June 2026

🗂️ Docs & Reference: A Cleaner Split

We've tidied up how content is organized across the two main tabs — Docs and Reference — to better reflect what each one is for.

Going forward, the Reference tab is home to endpoint specs, OpenAPI definitions, and API-specific integration content. The Docs tab is where you'll find conceptual guides, explanations, and anything that helps you understand the why before diving into the how.

As part of this, a few sections have found a more natural home:

  • Getting Started, Merchandising, and API Integration Essentials have moved to the Docs tab, where they sit alongside other narrative and explanatory content.
  • Migration Guides are now organized into dedicated subfolders — one for Beacon 2.0 and one for the Searchspring → Athos transition — so it's easier to find what you're looking for.
  • Integration Roadmap is a new section at the top of the Reference tab, giving you a quick orientation before jumping into endpoints.

✍️ Documentation Updates

  • New: Choosing Your Integration Path – Helps you and your team decide between API, Snap SDK, Snap Templates, or Managed integration based on your stack and timeline.
  • New: Integration Roadmap Overview – A lightweight entry point at the top of the Reference tab to orient you before exploring the API.

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

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


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

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

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