Variants

Use the section that matches your caller: storefront clients use Shopper REST or Search, trusted services use Management, and signed-in customer flows use Auth. Prefer Search API for new discovery-heavy storefront work.

Use Variants when the job is about the exact purchasable version of a product: variant identity, status, prices, stock, shipping attributes, and variant-level tags.

Management API variant operations own product-scoped variant CRUD, app-wide variant listing, prices by store group and market, warehouse stock records, shipping attributes, variant tags, and bulk variant, price, or stock changes. Shopper API variant routes are read-only compatibility routes for storefront reads; prefer Search for new discovery-heavy storefront work.

Use Products when the shopper-recognizable product record changes. Use Variant Groups when related variants need shared presentation, media, or channel status. Use Variants when price, stock, or exact purchasable identity changes.

Shopper API · read

Read and inspect

Management API · read, create, update, remove, and bulk operations

Read and inspect

Create or attach

Update or repair

Remove or deactivate

Bulk operations