within · luxury boutiques

Search the boutiques' shelves

search_pieces

Read-onlyIdempotent

Search pieces (clothing, shoes, bags, jewellery, watches, objects) in stock right now at independent luxury boutiques, with live sizes, price in the boutique's currency, the shop that holds each piece, and the shopwithin.co page to buy it. Use this when someone wants to find or compare a kind of piece, a designer's pieces at boutiques, a gift, or what is in stock in a city. A plain sentence works as the query (prices like 'under $400' and 'cheapest' are understood); brands, categories, sizes, boutiques, or city narrow it. With no arguments it returns the current front shelf; lens browses new arrivals, most saved, or marked down. Do not use for general style advice or for mass market retailers.

Input Schema

TableJSON Schema

Name	Required	Description
`city`	No	Only boutiques in this city, e.g. 'Toronto'. If within has no boutiques there yet, the answer says so and names the live cities.
`lens`	No	Browse a shelf instead of searching: 'new' = just arrived, 'trending' = what people are saving, 'sale' = marked down. Ignored when a query or filters are given.
`sort`	No
`limit`	No	Pieces per page, default 12.
`query`	No	What the shopper wants, in plain words: 'black leather loafers', 'Lemaire', 'a birthday gift for my dad under $300'.
`sizes`	No	Sizes that must be in stock, as labelled on the shelf: 'M', '42', 'US 9', 'IT 38'.
`brands`	No	Designer or house names to restrict to, exactly as they appear in results.
`offset`	No	Pieces to skip; use next_offset from the previous page.
`boutiques`	No	Boutique domains to restrict to, as shown on boutiques and pieces (e.g. 'wdlt117.myshopify.com').
`price_max`	No	Highest price to include, in the boutique's currency.
`price_min`	No	Lowest price to include, in the boutique's currency.
`categories`	No	Product types to restrict to, e.g. 'Sneakers', 'Bags'; take values from a previous result's facets.