Creating a catalog
Every product in Alana Shopping lives inside a catalog. Create one to start organizing your products:
curl -X POST "https://app.alana.shopping/api/workspace/{workspaceId}/catalogs" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Spring 2026",
"description": "Seasonal collection for Spring 2026"
}'
Publishing workflow
The recommended workflow for managing product content follows a fork-edit-merge pattern:
Publish a catalog
curl -X POST ".../catalogs/{catalogId}/publish" \
-H "Authorization: Bearer YOUR_API_KEY"
/api/catalog/products.
Fork for editing
curl -X POST ".../catalogs/{catalogId}/fork" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{"name": "Spring 2026 — QA Review"}'
Merge changes back
curl -X POST ".../catalogs/{catalogId}/merge" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{"targetCatalogId": "PARENT_CATALOG_ID"}'
Batch actions
Run pipeline stages in bulk from the catalog view or via API:
- Normalize (Silver) — field mapping, duplicate detection, image URL validation for a selection or entire catalog
- Analyze (Gold) — optimization scoring across 7 rubric stages, produces score + gaps list per product
# Batch Silver — normalize entire catalog
curl -X POST ".../workspace/{workspaceId}/catalogs/{catalogId}/batch/silver" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{"scope": "all"}'
# Batch Gold — score entire catalog
curl -X POST ".../workspace/{workspaceId}/catalogs/{catalogId}/batch/gold" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{"scope": "all"}'
Pipeline settings
Customize how Silver and Gold process your products:
- Silver field mappings — map source column names to Alana schema fields
- Gold scoring weights — adjust weights per rubric stage (identity, content, media, etc.)
- Auto-trigger — automatically run Silver after Bronze, or Gold after Silver
See Pipeline Settings for the full configuration guide.
Score evolution tracking
The optimization score is tracked over time in score_history. Use this to measure the impact of content improvements — before and after running AI enhancement or batch normalize.
Catalog statistics
Each catalog tracks key metrics that help you assess content quality:
- Total products — how many products are in the catalog
- Feed-ready count — products that pass all validation rules
- Average optimization score — mean quality score across all products
- Score distribution — breakdown by excellent/good/warning/poor bands
- Last published — when the catalog was last pushed live
Aim for 100% feed-ready products before publishing. Run Batch Gold first to identify which products need the most attention.
