Wardrobe Connect

Find clothes that match a description. For when the user describes a piece of clothing they want ("black pleated wide-leg trousers", "cream cable-knit jumper like the one I saved"). Natural requests are fine ("a navy midi wrap dress for a summer wedding under £60 in a size 12"): the occasion is kept out of the search and returned in `occasion`, and a price or size in the words is used when max_price or size is not passed. Returns eBay listings in the Clothing, Shoes and Accessories category, closest matches first and then cheapest first (from a best-match and a price-sorted search), plus search links for other shops and a Facebook Marketplace search phrase. Listings must match the colour and fabric named, the same kind of garment (by title and by eBay category, so socks never answer a search for trainers), and men's or women's if given; kids' items only when asked for. Adult, fetish and costume listings are never shown, repeat listings of the same item count once, and listings far below the typical price for the search (usually bait or junk) are left out.

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "A clear description of the item: colour, type, fabric or style, brand if known."
    },
    "size": {
      "type": "string",
      "description": "The user's size, for example M, XL, 12, UK 9, US 8.5, EU 39 or W32. Numbers without UK, US or EU are read in the country's usual sizes. Dress and shoe sizes are converted between UK, US and EU, and dress sizes to S, M and L. Listings that state a different size are left out; listings that state the size come first (size_listed true), then ones that don't say."
    },
    "max_price": {
      "type": "number",
      "description": "Most the user wants to pay, in their local currency, shipping included."
    },
    "condition": {
      "type": "string",
      "enum": [
        "any",
        "new",
        "used"
      ],
      "description": "Condition: new, used (pre-owned) or any. Default any. pre-owned and second-hand are read as used."
    },
    "country": {
      "type": "string",
      "description": "Two-letter country code. Defaults to where the request comes from. Supported: US, GB, IE, CA, AU, DE, FR, IT, ES."
    }
  },
  "required": [
    "q"
  ],
  "additionalProperties": false
}

Find clothes that look like a picture. For when the user shares or points at a picture of an outfit or item (a Pinterest pin, a saved post, a photo). Takes the image's direct https link. Returns visually similar eBay listings from the Clothing, Shoes and Accessories category only, in eBay's look-alike order. If the picture does not look like one piece of clothing (the results are scattered across unrelated kinds), `matches` is empty and the say line asks what the item is. A short description in q makes results match it, which removes look-alikes of the wrong kind.

{
  "type": "object",
  "properties": {
    "image_url": {
      "type": "string",
      "description": "Direct https link to a JPEG, PNG or WebP picture, 6 MB at most."
    },
    "q": {
      "type": "string",
      "description": "Which item in the picture, for example \"the camel coat\". Results must match it, and it is used as a fallback text search."
    },
    "size": {
      "type": "string",
      "description": "Clothing or shoe size to match, for example M, 10 or UK 8."
    },
    "max_price": {
      "type": "number",
      "description": "Highest price, in the local currency."
    },
    "condition": {
      "type": "string",
      "enum": [
        "any",
        "new",
        "used"
      ],
      "description": "Condition: any, new or used."
    },
    "country": {
      "type": "string",
      "description": "Two-letter country code for the eBay site and currency, for example US or GB."
    }
  },
  "required": [
    "image_url"
  ],
  "additionalProperties": false
}