Skip to main content

​
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"
Once published, the catalog’s products appear in the public feed at /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"}'

​
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
  • Last published — when the catalog was last pushed live
Aim for 100% feed-ready products before publishing. The optimization score helps identify which products need more work.