Besot: Musician Fashion Resale

Find where to buy a specific piece of clothing or footwear connected to the people we obsess over, and get every live resale listing for it in one call. Use this when someone asks questions like: where can I buy the Gucci HA HA HA blazer; is the Ivy Park Drip 2 hoodie listed in a medium; what is the Pleasing crewneck going for right now; which platforms have the Oasis adidas Original Forever trainers in a UK 9; what Beatles Comme des Garcons pieces are on the resale market today. Most of these garments are sold out at retail and exist only on resale, scattered across marketplaces under inconsistent seller titles. besot gives each garment one canonical name and pulls the live listings for that exact piece from eBay, StockX, GOAT, The RealReal, Vestiaire, Grailed, Poshmark and Depop. Covers clothing and footwear that the people we obsess over designed, founded, were the inspiration for, or wore. Takes plain language in q (for example "Ivy Park Drip 2 hoodie" or "Harry Styles Gucci blazer"), with optional filters for artist, brand, collection, garment type, size, condition, source platform, and price range. Every listing returned carries the platform, size, condition, price (approximate USD, null when the seller did not state one), and a direct buy link.

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "maxLength": 500,
      "description": "Free text over piece name, collection, artist, brand, and garment vocabulary. Product names are canonical (Gazelle, Firebird Track Top), so plain garment words work too, in British or American English: trainers or sneakers, jumper or sweater, trousers or pants, trackie or tracksuit."
    },
    "artist": {
      "type": "string",
      "maxLength": 200
    },
    "collection": {
      "type": "string",
      "maxLength": 200,
      "description": "Collection id (exact)"
    },
    "brand": {
      "type": "string",
      "maxLength": 200,
      "description": "Designer/brand name"
    },
    "type": {
      "type": "string",
      "maxLength": 100,
      "description": "COLLECTION type: Collab, Capsule, or Own brand. For the garment, use category."
    },
    "category": {
      "type": "string",
      "maxLength": 100,
      "description": "GARMENT category, one of: footwear, outerwear, tops, knitwear, hoodies, bottoms, one-pieces, suits, sets, accessories, eyewear, swim-active"
    },
    "size": {
      "type": "string",
      "maxLength": 100,
      "description": "Match a listing size; call get_facets for valid values"
    },
    "condition": {
      "type": "string",
      "maxLength": 100
    },
    "source": {
      "type": "string",
      "maxLength": 200,
      "description": "Resale platform, e.g. ebay, grailed, therealreal"
    },
    "minPrice": {
      "type": "number"
    },
    "maxPrice": {
      "type": "number"
    },
    "sort": {
      "type": "string",
      "maxLength": 100,
      "enum": [
        "price-asc",
        "price-desc",
        "name"
      ]
    },
    "limit": {
      "type": "integer",
      "description": "1-50, default 20"
    }
  }
}

Get the complete set of live resale listings for one specific garment, with a direct buy link for each. Call search_pieces first: it returns the collectionId and pieceId this tool needs. Use this once someone has settled on a specific piece and wants every option available: all platforms, all sizes, all conditions, with prices wherever a live feed provides one. For example, after a search surfaces the Ivy Park Drip 2 Oversized Hoodie, use this to show every listing of it currently for sale and where to buy each one.

{
  "type": "object",
  "properties": {
    "collectionId": {
      "type": "string",
      "maxLength": 200
    },
    "pieceId": {
      "type": "string",
      "maxLength": 200
    }
  },
  "required": [
    "collectionId",
    "pieceId"
  ]
}

List the collections besot indexes: collaborations between the people we obsess over and design houses, capsule drops, and brands they founded and own. Use this when someone asks what a given artist has made, which artists have worked with a given brand, or what is covered before running a search. For example: what fashion has Harry Styles designed; which artists have collaborated with adidas; what Beatles clothing collections exist. Coverage includes Harry Styles (Gucci HA HA HA, Pleasing), Beyonce (Ivy Park with adidas), Oasis, Liam Gallagher and Noel Gallagher (adidas), and The Beatles (Comme des Garcons, Stella McCartney, Alice + Olivia), and grows as new fandoms are added. Filter by artist, or by type: collaboration, capsule, or artist-founded brand.

{
  "type": "object",
  "properties": {
    "artist": {
      "type": "string",
      "maxLength": 200
    },
    "type": {
      "type": "string",
      "maxLength": 100,
      "description": "Collab, Capsule, or Own brand"
    }
  }
}

Return the values that actually exist in the catalogue for filtering a search: sizes, conditions, source platforms, artists, designers, and the price range. Use this before search_pieces when you want to build a precise query from real values rather than guesses. For example, to check which sizes of a garment are genuinely listed right now, or which platforms currently carry a given collection.

{
  "type": "object",
  "properties": {}
}