Collections API reference
Reference map for Collections API operations.
- Updated
- Apr 26, 2026
Collections
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 Collections when the job is about curated product groupings and collection hierarchy, not taxonomy-wide category navigation.
Management API collection operations own collection records, nested collection trees, product membership, and bulk collection or membership changes. Shopper API collection routes are read-only compatibility routes for storefront collection reads; prefer Search for new discovery-heavy storefront work.
Use collection-product operations when a product is being added to or removed from a curated collection. Use Products when the product record itself is changing.
For workflow guidance across taxonomy, curated merchandising groups, reusable labels, brand/series records, templates, and storefront discovery reads, see Catalog organization and discovery.
Shopper API · read
Read and inspect
| Operation | API |
|---|---|
| Fetch a collection by URI | Shopper API |
| Fetch all collection slugs | Shopper API |
| Fetch all collections | Shopper API |
Management API · read, create, update, remove, and bulk operations
Read and inspect
| Operation | API |
|---|---|
| Get a collection by ID | Management API |
| Get collection tree | Management API |
| List all collections | Management API |
| List products in a collection | Management API |
Create or attach
| Operation | API |
|---|---|
| Add products to collection | Management API |
| Create a new collection | Management API |
Update or repair
| Operation | API |
|---|---|
| Update a collection | Management API |
Remove or deactivate
| Operation | API |
|---|---|
| Delete a collection | Management API |
| Remove products from collection | Management API |
Bulk operations
| Operation | API |
|---|---|
| Bulk add products to collections | Management API |
| Bulk create collections | Management API |
| Bulk delete collections | Management API |
| Bulk remove products from collections | Management API |
| Bulk update collections | Management API |