Products

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 Products when the job is about the shopper-recognizable catalog item: product identity, descriptions, status, taxonomy relationships, media relationships, tags, collections, and bulk product administration.

Management API product operations own trusted product creation, updates, duplication, deletion, soft deletion, image attachment, category membership, collection membership, tag membership, and bulk product changes. Shopper API product routes are read-only compatibility routes for storefront reads; prefer Search for new discovery-heavy storefront work.

Use Variants when the exact purchasable version, price, stock, or variant-level tag is changing. Use Variant Groups when group-level presentation or channel status is changing. Use Products when the product record or product-level relationships are the thing being changed.

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