Calculate batch fit scores

Calculate personalized fit scores for published products belonging to the authenticated vendor, based on a customer's skin analysis data. Optionally pass an array of SKUs to score only specific products; if omitted, all published products are scored. Uses a hybrid scoring approach combining embedding similarity (75% weight) with algorithmic skin type matching (25% weight). Products containing customer allergens score 0.

Requires a completed skin scan batch. The customer's skin profile embedding is cached per scan batch for 24 hours, so subsequent calls are fast.

Authentication: Vendor Bearer token required. The vendor is derived from the authenticated context — no vendor_id parameter needed.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required

Skin analysis batch ID to use for scoring. The customer is derived from the analysis records associated with this batch.

skus
array of strings
length ≤ 200

Optional list of product SKUs to score. When provided, only these products are scored (must be published and belong to the vendor). When omitted, all published vendor products are scored. Unrecognized SKUs are silently ignored. Maximum 200 items.

skus
Responses

Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json