Recommendations API

For server-rendered and headless storefronts, search results and carts: your server asks for the shopper’s size for up to 25 products at once, in your size labels.

1. In the browser, tys.recommendationHandle() returns an opaque, encrypted handle (valid for an hour). Your page cannot read anything in it.
2. Your page sends the handle to your server with its request.
3. Your server calls POST /v1/recommendations with a secret or restricted key (fit_checks:read).

const { data } = await tys.recommendations.create({ handle, products: ["SKU-123", "SKU-456"] });

Each answer is ready (with size and wearable_sizes), computing, none or unavailable. The call never starts a simulation and never returns measurements.

Server-side recommendationsThe full guide, with caching and errors.

Node.js referencetys.recommendations.create()

Python referencetys.recommendations.create()