besot Pieces API
The Pieces API from besot — 2 operation(s) for pieces.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/besot-com:besot-com-pieces-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Besot Com Pieces API
version: 1.0.1
description: 'Operations tagged Pieces across 2 of this provider''s published API definitions: openapi.json, besot-com-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://thebesot.com/catalogue
tags:
- name: Pieces
paths:
/pieces:
get:
operationId: searchPieces
summary: Search and filter pieces across all collections
parameters:
- name: q
in: query
schema:
type: string
description: 'Free text. All words must match, in any order, across piece name, collection, artist, brand, and garment words (British or American: trainers or sneakers, jumper or sweater).'
- name: artist
in: query
schema:
type: string
- name: collection
in: query
schema:
type: string
description: Collection id (exact)
- name: brand
in: query
schema:
type: string
description: Designer/brand
- name: category
in: query
schema:
type: string
enum:
- footwear
- outerwear
- tops
- knitwear
- hoodies
- bottoms
- shorts
- one-pieces
- suits
- sets
- accessories
- eyewear
- bags
- jewelry
- swim-active
description: Garment category. This is the garment filter, NOT `type`.
- name: type
in: query
schema:
type: string
enum:
- Collab
- Capsule
- Own brand
description: COLLECTION type, not the garment. For a garment use `category`.
- name: size
in: query
schema:
type: string
description: Matches a listing size (see /facets)
- name: condition
in: query
schema:
type: string
- name: source
in: query
schema:
type: string
description: Resale platform
- name: minPrice
in: query
schema:
type: number
- name: maxPrice
in: query
schema:
type: number
- name: sort
in: query
schema:
type: string
enum:
- price-asc
- price-desc
- name
- name: limit
in: query
schema:
type: integer
default: 50
maximum: 200
- name: offset
in: query
schema:
type: integer
default: 0
responses:
'200':
description: Matching pieces
content:
application/json:
schema:
type: object
properties:
total:
type: integer
count:
type: integer
limit:
type: integer
offset:
type: integer
pieces:
type: array
items:
type: object
properties:
id:
type: string
url:
type: string
description: Canonical besot piece page
name:
type: string
fromPrice:
type:
- number
- 'null'
description: Lowest live listed price across indexed sources, approx USD
image:
type:
- string
- 'null'
collectionId:
type: string
collectionName:
type: string
artist:
type: string
brand:
type: string
listings:
type: array
items:
type: object
properties:
source:
type: string
description: Resale platform (ebay, grailed, therealreal, vestiaire, poshmark, stockx)
price:
type:
- number
- 'null'
description: Approx USD, null when the seller stated no price
currency:
type: string
condition:
type:
- string
- 'null'
size:
type:
- string
- 'null'
color:
type:
- string
- 'null'
image:
type:
- string
- 'null'
url:
type: string
description: Affiliate-wrapped outbound buy link to the seller. Follow this to purchase.
tags:
- Pieces
servers:
- url: https://thebesot.com/catalogue
/pieces/{collectionId}/{pieceId}:
get:
operationId: getPiece
summary: One piece with all its listings across indexed sources
parameters:
- name: collectionId
in: path
required: true
schema:
type: string
- name: pieceId
in: path
required: true
schema:
type: string
responses:
'200':
description: Piece
content:
application/json:
schema:
type: object
properties:
id:
type: string
url:
type: string
description: Canonical besot piece page
name:
type: string
fromPrice:
type:
- number
- 'null'
description: Lowest live listed price across indexed sources, approx USD
image:
type:
- string
- 'null'
collectionId:
type: string
collectionName:
type: string
artist:
type: string
brand:
type: string
listings:
type: array
items:
type: object
properties:
source:
type: string
description: Resale platform (ebay, grailed, therealreal, vestiaire, poshmark, stockx)
price:
type:
- number
- 'null'
description: Approx USD, null when the seller stated no price
currency:
type: string
condition:
type:
- string
- 'null'
size:
type:
- string
- 'null'
color:
type:
- string
- 'null'
image:
type:
- string
- 'null'
url:
type: string
description: Affiliate-wrapped outbound buy link to the seller. Follow this to purchase.
'404':
description: Not found
tags:
- Pieces
servers:
- url: https://thebesot.com/catalogue
x-refined-from:
- openapi.json
- besot-com-openapi.json