New: Assortment Recommendations API tag fields

The Assortment Recommendations API has new tag values to help sellers understand why an item is recommended. The updated tags include BEST_SELLER, TRENDING, FIRST_MOVER, and HIGHLY_SEARCHED.

What changed

Added: Updated tag values to reflect current demand intelligence signals.

Added: Clearer recommendation context with values such as BEST_SELLER, TRENDING, FIRST_MOVER, and HIGHLY_SEARCHED. The tag logic now better reflects search trends, sales velocity, and early demand signals.

Removed: Outdated or deprecated values, such as the shoppingTrends parameter, that are being replaced with clearer demand-based classifications.

Why it matters

Clearer recommendations: Sellers can now better understand why an item is recommended.

Faster listing decisions: More specific tags help sellers evaluate and prioritize assortment opportunities.

Improved trust: Updated demand signals make recommendations more actionable and easier to use.

Next steps

  • Update downstream systems to support the updated tag values.
  • Avoid relying on stale or deprecated tag values for item prioritization.
  • Refer to the updated Assortment Recommendations API documentation for field definitions, response examples, and validation details.