boutique_shelf

One boutique's shelf right now, newest first, with sizes and prices; a query searches inside that shop only. Use this when a shopper names a specific boutique ('what does WDLT117 have', 'show me Utopia's sneakers') or wants to browse a shop they read about. boutique_domain is the domain shown on any boutique or piece.

read-only

Argument	Type	Description
limit	integer	Default 12.
query	string	Search inside this boutique only.
offset	integer
boutique_domain*	string	The boutique's domain, as shown on boutiques and pieces (e.g. 'utopia-kicks.myshopify.com').

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "boutique_domain"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 24,
      "minimum": 1,
      "description": "Default 12."
    },
    "query": {
      "type": "string",
      "maxLength": 200,
      "description": "Search inside this boutique only."
    },
    "offset": {
      "type": "integer",
      "maximum": 480,
      "minimum": 0
    },
    "boutique_domain": {
      "type": "string",
      "maxLength": 120,
      "description": "The boutique's domain, as shown on boutiques and pieces (e.g. 'utopia-kicks.myshopify.com')."
    }
  }
}

convert_size

Turn a size in one system into every other system: rings, shoes, clothing, suits, belts and hats, or one designer's own chart (pass designer as its slug, e.g. 'nike'). Answers only from the size tables on shopwithin.co/sizes, where every row comes from a named source with the day it was read, and returns the page that shows the answer. Use this when a shopper asks what their size is in another country's system, which size to take in a designer, or how a designer's sizes run. Call it without from and size to list the systems and tables a kind or a designer has.

read-only

Argument	Type	Description
to	string	Optional: one system key to lead the answer with.
from	string	The system the size is written in, as a key this tool lists, e.g. 'us', 'uk', 'eu'.
kind	string	What is being sized: rings, shoes, clothing, suits, belts or hats.
size	string	The size as printed, e.g. '7', 'N 1/2', '42', 'M'.
table	string	Optional: one table or chart id this tool lists.
designer	string	A designer's slug, as in shopwithin.co/designers/<slug>, to read that designer's own charts instead of a kind.
department	string	Optional: only women's or men's tables.

estimate_duty

Work out what a piece of clothing, a pair of shoes, a bag, jewellery, a watch or an accessory costs at the door when it is shipped to the US, Canada, the UK or Australia: the duty, any extra tariff on the country it was made in, the tax, the government and carrier fees, and the total. Every line names its official source and the day it was read, and the answer links the page on shopwithin.co/duty-calculator that shows it. Use this when a shopper asks about customs, duty, tariffs or import tax on a cross-border order. It is an estimate; the carrier's bill is the final word.

read-only

Argument	Type	Description
to*	string	Where the piece is shipped to.
kind*	string	What the piece is, one of: coat-wool, coat-cotton, coat-polyester, puffer-down, jacket-wool, jacket-cotton, jacket-polyester, jacket-leather, blazer-wool, blazer-cotton, blazer-polyester, trousers-wool, trousers-cotton, trousers-polyester, dress-wool, dress-cotton, dress-silk, dress-polyester, skirt-wool, skirt-cotton, skirt-polyester, shirt-cotton, shirt-silk, shirt-polyester, tshirt-cotton, tshirt-polyester, sweater-cashmere, sweater-wool, sweater-cotton, sweater-polyester, shoes-leather, sneakers-leather, boots-leather, sneakers-textile, bag-leather, bag-textile, wallet-leather, jewellery-gold, jewellery-silver, jewellery-costume, watch-automatic, watch-gold, belt-leather, scarf-silk, scarf-wool, tie-silk, sunglasses.
price*	number	The price, without shipping.
usmca	boolean	US only: true if a piece made in Canada or Mexico qualifies under USMCA.

get_piece

One piece in full: description, every size or variant with live stock, photographs, price and any markdown, whether it is collected in the shop or delivered, the boutique, the page to buy it, and a few pieces in the same vein. Use this when a shopper asks about a specific piece from a result, pastes a shopwithin.co link, or wants to know whether a size is in stock before buying. Identify the piece by url, or by boutique_domain and id from a previous result.

read-only

Argument	Type	Description
id	string	The piece's id from a previous result.
url	string	A shopwithin.co piece link, e.g. https://shopwithin.co/product/<boutique>/<id>.
boutique_domain	string	The piece's boutique_domain from a previous result.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "id": {
      "type": "string",
      "maxLength": 80,
      "description": "The piece's id from a previous result."
    },
    "url": {
      "type": "string",
      "maxLength": 400,
      "description": "A shopwithin.co piece link, e.g. https://shopwithin.co/product/<boutique>/<id>."
    },
    "boutique_domain": {
      "type": "string",
      "maxLength": 120,
      "description": "The piece's boutique_domain from a previous result."
    }
  }
}

list_boutiques

The independent luxury boutiques listed on within, with neighbourhood, city, how many pieces each has live, opening hours, and whether a shopper collects in the shop or can have pieces delivered. Use this when someone asks which shops are on within, what is in a city or neighbourhood, or where to visit in person. The returned domain identifies a boutique everywhere else.

read-only

Argument	Type	Description
city	string	Only boutiques in this city, e.g. 'Toronto'.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "city": {
      "type": "string",
      "maxLength": 60,
      "description": "Only boutiques in this city, e.g. 'Toronto'."
    }
  }
}

search_pieces

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.

read-only

Argument	Type	Description
city	string	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	string	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	string
limit	integer	Pieces per page, default 12.
query	string	What the shopper wants, in plain words: 'black leather loafers', 'Lemaire', 'a birthday gift for my dad under $300'.
sizes	array	Sizes that must be in stock, as labelled on the shelf: 'M', '42', 'US 9', 'IT 38'.

similar_pieces

Pieces in the same vein as one piece: same spirit, same department, across every boutique, in stock now. Use this when a shopper likes a piece but wants alternatives, another price, or another shop. Identify the anchor piece by url, or by boutique_domain and id.

read-only

Argument	Type	Description
id	string
url	string	A shopwithin.co piece link.
limit	integer	Default 8.
boutique_domain	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "id": {
      "type": "string",
      "maxLength": 80
    },
    "url": {
      "type": "string",
      "maxLength": 400,
      "description": "A shopwithin.co piece link."
    },
    "limit": {
      "type": "integer",
      "maximum": 12,
      "minimum": 1,
      "description": "Default 8."
    },
    "boutique_domain": {
      "type": "string",
      "maxLength": 120
    }
  }
}

trending_now

within's chart of the designer pieces trending at independent boutiques this week, updated daily: the top ten in order, each with its reason (Google searches, Pinterest searches, what boutiques worldwide are stocking, what people look at on within), its place last week and its weeks on the list, plus the designers of the week. Use this when someone asks what is trending in designer or luxury fashion right now, which designers or pieces are hot this week, or what is trending in a kind of piece (sneakers, bags, jackets, boots, jewelry…). dept narrows to women or men; kind to one kind of piece. Each piece has a url to buy it. Do not use for mass market retailers or for last year's trends.

read-only

Argument	Type	Description
dept	string	The women's or the men's chart; leave out for everyone's.
kind	string	One kind of piece, e.g. 'sneakers', 'bags', 'jackets', 'boots', 'jewelry', 'dresses'.
limit	integer	How many places to return, up to ten, default 10.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "dept": {
      "enum": [
        "women",
        "men"
      ],
      "type": "string",
      "description": "The women's or the men's chart; leave out for everyone's."
    },
    "kind": {
      "enum": [
        "sneakers",
        "boots",
        "loafers",
        "sandals",
        "heels",
        "jackets",
        "hoodies",
        "knitwear",
        "t-shirts",
        "shirts",
        "pants",
        "jeans",
        "shorts",
        "dresses",
        "skirts",
        "suits",
        "activewear",
        "bags",
        "jewelry",
        "watches",
        "eyewear",
        "hats",
        "scarves",
        "wallets",
        "belts"
      ],
      "type": "string",
      "description": "One kind of piece, e.g. 'sneakers', 'bags', 'jackets', 'boots', 'jewelry', 'dresses'."
    },
    "limit": {
      "type": "integer",
      "maximum": 10,
      "minimum": 1,
      "description": "How many places to return, up to ten, default 10."
    }
  }
}

visual_search

Pieces on the boutiques' shelves that resemble a photograph: a screenshot, a street style shot, a product photo, or a TikTok or Pinterest link. Answers in two tiers: pieces close enough to be the same or a near twin, and pieces in the same spirit. Use this when a shopper shares an image of something they want to find or 'something like this'. Pass image_url for a direct image, image_base64 with media_type for an uploaded file, or post_url for a TikTok or Pinterest link. Photographs are matched in memory and never stored. Do not use for Instagram links; they cannot be read, so ask for a screenshot instead.

read-only

Argument	Type	Description
post_url	string	A TikTok or Pinterest post link; the photograph is read from the post.
image_url	string	A direct, publicly reachable JPEG, PNG or WebP URL (under 1.5 MB).
image_file	object	A photograph the shopper uploaded in the chat; the host passes the file here.
media_type	string	Required with image_base64.
image_base64	string	The image bytes, base64 encoded (under 1.5 MB decoded).

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "post_url": {
      "type": "string",
      "maxLength": 500,
      "description": "A TikTok or Pinterest post link; the photograph is read from the post."
    },
    "image_url": {
      "type": "string",
      "maxLength": 2000,
      "description": "A direct, publicly reachable JPEG, PNG or WebP URL (under 1.5 MB)."
    },
    "image_file": {
      "type": "object",
      "required": [
        "download_url"
      ],
      "properties": {
        "file_id": {
          "type": "string"
        },
        "file_name": {
          "type": "string"
        },
        "mime_type": {
          "type": "string"
        },
        "download_url": {
          "type": "string",
          "maxLength": 4000
        }
      },
      "description": "A photograph the shopper uploaded in the chat; the host passes the file here."
    },
    "media_type": {
      "enum": [
        "image/jpeg",
        "image/png",
        "image/webp"
      ],
      "type": "string",
      "description": "Required with image_base64."
    },
    "image_base64": {
      "type": "string",
      "maxLength": 2000000,
      "description": "The image bytes, base64 encoded (under 1.5 MB decoded)."
    }
  }
}

within · luxury boutiques

Try it

boutique_shelf Read-only

within · luxury boutiques

Try it

boutique_shelf Read-only

Tools (9)