Tags API reference
Reference map for Tags API operations.
- Updated
- Apr 26, 2026
Tags
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 Tags when the job is about reusable catalog labels, tag availability by market, or tag relationships to products and variants.
Management API tag operations own tag creation, updates, deletion, market association, product-by-tag listing, and bulk product/variant tag relationships. Shopper API tag routes are read-only compatibility routes for storefront tag reads; prefer Search for new discovery-heavy storefront work.
Use tag relationship operations when the tag already exists and the product, variant, or market association is changing. Use the tag create/update/delete operations when the tag record itself is changing.
For workflow guidance across reusable labels, taxonomy, curated merchandising groups, brand/series records, templates, and storefront discovery reads, see Catalog organization and discovery.
Shopper API · read
Read and inspect
| Operation | API |
|---|---|
| Fetch all tags | Shopper API |
| Fetch tag by ID | Shopper API |
| Fetch tag by key | Shopper API |
Management API · read, create, update, remove, and bulk operations
Read and inspect
| Operation | API |
|---|---|
| Get a tag by key | Management API |
| List all tags | Management API |
| List products by tag | Management API |
Create or attach
| Operation | API |
|---|---|
| Associate tag with market | Management API |
| Create a new tag | Management API |
Update or repair
| Operation | API |
|---|---|
| Update a tag | Management API |
Remove or deactivate
| Operation | API |
|---|---|
| Delete a tag | Management API |
| Remove tag from market | Management API |
Bulk operations
| Operation | API |
|---|---|
| Bulk Add Products to Tags | Management API |
| Bulk Add Variants to Tags | Management API |
| Bulk Create Tags | Management API |
| Bulk Delete Tags | Management API |
| Bulk Remove Products from Tags | Management API |
| Bulk Remove Variants from Tags | Management API |
| Bulk Update Tags | Management API |