trendsly.ca

Use Trendsly to discover fashion from evidence-backed Canadian-founded or Canadian-based brands. Start with search_products for an item or list_brands when the brand name is unknown. Use get_brand_details for evidence-backed facts about one exact listed brand, and browse_brand_products to browse products from that exact brand. Treat result_count as rows returned on this page and total_available as the backend estimate for the bound result set. Use status to distinguish a true empty result from an abstained or unsupported request. Follow next_cursor for more results and repeat the original limit and include_sold_out value exactly. A Canadian brand claim does not mean every product is made in Canada. Use manufacturing_country=CA and inspect canadian_claim when origin matters. Search results expose a compatibility id. Pass it to get_product_context as product_ref {kind: "legacy_public", value: id}; get_product_context returns canonical_product_id, which is the only ID that should key durable shopping state. Use get_product_context with canonical product IDs or typed Trendsly aliases to retrieve current price, observed history, availability, alternatives, purchase readiness, or a comparison without revisiting retailer pages. Use get_shopping_state to read a persistent cart, list, watch state, purchase plan, or public share. Create returns state_id plus a separate secret edit_capability. Store the capability like a credential and send it only to Trendsly for private reads or mutations. For create, generate idempotency_key as create_ plus the canonical unpadded base64url encoding of 32 cryptographically random bytes. Treat this create-recovery key like a credential and reuse it only for the identical create retry. For every later mutation, send state_ref equal to state_id, edit_capability, expected_revision, and an idempotency_key. Reuse an idempotency key only when retrying the identical mutation. A public cart share is read-only. Never expose or infer write capabilities from a share URL. Read trendsly://catalogue/guide for field semantics, pagination rules, and recommended workflows.