Get Recommended Outfits
looks.curation.recommendGet complete recommended outfits. Pass a product 'handle' to find complementary items styled with it, OR pass an 'occasion' (e.g. 'Wedding & Reception', 'Party', 'Cocktail', 'Date Night', 'Formal') and 'gender' to discover full occasion looks. All returned looks are verified 100% in-stock (any look with an out-of-stock item is excluded). Automatically localized to active country / 240+ destination regions.
PURPOSE & DISAMBIGUATION:
Generates harmonized outfits coordinated around a seed product handle or occasion theme.
Distinct from 'products.search.alternatives': Use 'looks.curation.recommend' to build coordinating outfits with different garment pieces (e.g. pairing pants and shoes with a shirt); use 'products.search.alternatives' to find visual replacements for the exact same garment.
Distinct from 'looks.curation.by_occasion': 'looks.curation.recommend' supports building outfits around a specific chosen product handle as well as occasion themes.
WHEN TO USE:
When a user has selected a product and asks 'How do I style this?' or 'Show me outfits with this shirt'.
When discovering coordinated outfit recommendations for an occasion.
WHEN NOT TO USE:
Do NOT use to find substitute alternatives of the same garment (use 'products.search.alternatives').
Do NOT use for basic keyword search (use 'products.search.text').
BEHAVIOR & SAFETY:
Read-only and idempotent with no persistent state modifications.
Filters out any outfit containing out-of-stock items (guarantees 100% purchaseable looks).
Enriches all included items with verified purchase permalinks and policy strings.
PARAMETERS & CONSTRAINTS:
'handle' (string, optional): Product handle identifier to build coordinating outfits around (e.g. 'solid-linen-shirt').
'occasion' (string, optional): Target occasion or theme (e.g. 'Wedding & Reception', 'Party', 'Cocktail', 'Date Night', 'Formal').
'gender' (enum, default 'women'): Target gender filter ('women', 'men', 'female', 'male').
'country' (string, optional): Target country name, city, currency, or ISO-2 code (e.g. 'US', 'United States', 'UK', 'Dubai', 'CA', 'IN'). Defaults to active saved region.
'mode' (enum, optional): Catalog mode: 'global' (ships to country) or 'local' (domestic only).
'page' (integer >= 1, default 1): Pagination page number.
'page_size' (integer 1-100, default 20): Number of outfit sets per page.
MANDATORY AGENT INSTRUCTIONS:
Always inform the user of available in-stock sizes, fast shipping SLA, and return policy for each item (Negative return days = 'Exchange only |X| days').
When shortlisting a look, render the product specifications table (Fabric, Pattern, Collar, Sleeves, Fit, Care).
Provide the base link (https://s.polopan.com/p/{handle}) during shortlisting. Provide direct 1-click checkout link (https://s.polopan.com/p/{handle}/{size_index}) ONLY after the user's size is finalized.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | Catalog mode: 'global' (ships to country) or 'local' (domestic only). Defaults to active saved region. | |
| page | No | Page number for pagination (1-indexed) | |
| gender | No | Target gender filter: 'women' or 'men' (default: 'women') | women |
| handle | No | Product handle identifier to build coordinating outfits around (e.g. 'solid-linen-shirt') | |
| country | No | Country name, city, currency, or 2-letter ISO code (e.g. 'US', 'United States', 'UK', 'Dubai', 'CA', 'IN'). Defaults to active saved region. | |
| occasion | No | Target occasion or aesthetic theme (e.g. 'Wedding & Reception', 'Party', 'Cocktail', 'Date Night', 'Formal') | |
| page_size | No | Number of outfit sets to return per page (1 to 100, default 20) |