Search Products By Text
products.search.textRead-only
Search PoloPan products using a text query and optional filters. Returns products with available in-stock sizes, specifications table, shipping/return policies, pricing, and verified purchase URLs (https://s.polopan.com/p/{handle}).
MANDATORY AGENT INSTRUCTIONS:
Always tell the user the available sizes for items, and display returning & shipping policies (Negative return days = 'Exchange only |X| days').
When presenting/shortlisting products, display the product specifications table.
Return the base link (https://s.polopan.com/p/{handle}) during browsing. Provide the direct checkout link (https://s.polopan.com/p/{handle}/{size_index}) ONLY after the user's size is finalized.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number for pagination (starts at 1) | |
| size | No | Array of sizes to filter by, e.g. ['S', 'M', 'L', 'XL'] | |
| query | Yes | The search query or style keyword to find fashion items (e.g. 'black leather jacket', 'floral summer midi dress') | |
| gender | No | Target gender filter: 'men', 'women', or 'unisex' | |
| vendor | No | List of brand or vendor names to filter by | |
| sort_by | No | Sorting criteria for the search results | relevance |
| page_size | No | Number of items to return per page (max 100) | |
| price_max | No | Maximum price in local currency | |
| price_min | No | Minimum price in local currency | |
| sort_order | No | Sort order: 'asc' for ascending, 'desc' for descending | desc |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| products | Yes | List of matching fashion products | |
| pagination | No | Pagination metadata |