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

OperationAPI
Fetch all tagsShopper API
Fetch tag by IDShopper API
Fetch tag by keyShopper API

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

Read and inspect

OperationAPI
Get a tag by keyManagement API
List all tagsManagement API
List products by tagManagement API

Create or attach

OperationAPI
Associate tag with marketManagement API
Create a new tagManagement API

Update or repair

OperationAPI
Update a tagManagement API

Remove or deactivate

OperationAPI
Delete a tagManagement API
Remove tag from marketManagement API

Bulk operations

OperationAPI
Bulk Add Products to TagsManagement API
Bulk Add Variants to TagsManagement API
Bulk Create TagsManagement API
Bulk Delete TagsManagement API
Bulk Remove Products from TagsManagement API
Bulk Remove Variants from TagsManagement API
Bulk Update TagsManagement API

Tags API reference

# 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](/start/concepts/catalog-organization-and-discovery).

18 operations grouped by API, then by the job they support.

## Shopper API · read ### Read and inspect | Operation | API | | --- | --- | | [Fetch all tags](/reference/tags/fetch-all-tags) | Shopper API | | [Fetch tag by ID](/reference/tags/fetch-tag-by-id) | Shopper API | | [Fetch tag by key](/reference/tags/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](/reference/tags/get-a-tag-by-key) | Management API | | [List all tags](/reference/tags/list-all-tags) | Management API | | [List products by tag](/reference/tags/list-products-by-tag) | Management API | ### Create or attach | Operation | API | | --- | --- | | [Associate tag with market](/reference/tags/associate-tag-with-market) | Management API | | [Create a new tag](/reference/tags/create-a-new-tag) | Management API | ### Update or repair | Operation | API | | --- | --- | | [Update a tag](/reference/tags/update-a-tag) | Management API | ### Remove or deactivate | Operation | API | | --- | --- | | [Delete a tag](/reference/tags/delete-a-tag) | Management API | | [Remove tag from market](/reference/tags/remove-tag-from-market) | Management API | ### Bulk operations | Operation | API | | --- | --- | | [Bulk Add Products to Tags](/reference/tags/bulk-add-products-to-tags) | Management API | | [Bulk Add Variants to Tags](/reference/tags/bulk-add-variants-to-tags) | Management API | | [Bulk Create Tags](/reference/tags/bulk-create-tags) | Management API | | [Bulk Delete Tags](/reference/tags/bulk-delete-tags) | Management API | | [Bulk Remove Products from Tags](/reference/tags/bulk-remove-products-from-tags) | Management API | | [Bulk Remove Variants from Tags](/reference/tags/bulk-remove-variants-from-tags) | Management API | | [Bulk Update Tags](/reference/tags/bulk-update-tags) | Management API |