Search minxa fashion
search_fashion_productsRead-onlyIdempotent
Find clothes, shoes, bags, jewelry, accessories and beauty products from 80+ online shops by describing them in plain English, e.g. 'a dress for a beach wedding' with max_price_usd 200, or 'black leather ankle boots with a low heel'. Returns up to 10 products with photo, price (in the shop's currency), brand, shop and a link to each product's page on minxa.com, plus a link to all results on minxa.com.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | How many products to return (1-10). | |
| query | Yes | What the person wants, in plain words: the item, colour, material, style, occasion, brand. | |
| gender | No | Whose clothes: women (minxa's default), men, or girls / boys for kids. Set it from the request: "men's linen shirts" is men, "something for my daughter" is girls; leave it out when the request doesn't say whose. | women |
| max_price_usd | No | Highest price in US dollars. When set, items the shop prices in another currency are left out. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| items | Yes | ||
| query | Yes | ||
| gender | Yes | ||
| fallback | No | Present only when the full search was busy and these are the newest items in the category the query names. | |
| disclosure | Yes | How minxa is paid. | |
| max_price_usd | Yes | ||
| total_matches | Yes | Cards minxa.com shows for this search (each colour is a card). | |
| minxa_search_url | Yes | All results for this search on minxa.com. |