{"info":{"description":"Search live authenticated Herm\u00e8s Birkin resale inventory, resolve buy URLs, get recommendations, market prices, and multilingual news.","title":"BirkinBagStock API","version":"1.0.0"},"openapi":"3.1.0","paths":{"/api/v1/buy/{id}":{"get":{"operationId":"getBuyUrl","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Buy URL and merchant handoff instructions."}},"summary":"Resolve a listing to its canonical buy URL"}},"/api/v1/inventory":{"get":{"operationId":"searchBirkinBags","parameters":[{"in":"query","name":"size","schema":{"enum":[25,30,35,40],"type":"integer"}},{"in":"query","name":"color","schema":{"type":"string"}},{"in":"query","name":"leather","schema":{"type":"string"}},{"in":"query","name":"min_price","schema":{"type":"integer"}},{"in":"query","name":"max_price","schema":{"type":"integer"}},{"in":"query","name":"condition","schema":{"type":"string"}},{"in":"query","name":"merchant","schema":{"type":"string"}},{"in":"query","name":"sort","schema":{"enum":["best","newest","price_asc","price_desc"],"type":"string"}},{"in":"query","name":"limit","schema":{"default":20,"maximum":500,"type":"integer"}}],"responses":{"200":{"description":"Live Birkin listings with detail_url and buy_url."}},"summary":"Search Birkin bag inventory"}},"/api/v1/listing/{id}":{"get":{"operationId":"getBirkinListing","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Listing specs, merchant, image, detail_url, and buy_url."}},"summary":"Get one Birkin listing"}},"/api/v1/news":{"get":{"operationId":"getBirkinNews","parameters":[{"in":"query","name":"locale","schema":{"enum":["en","es","fr","de","it","pt","ja","zh","ko","nl","tr","ar"],"type":"string"}},{"in":"query","name":"limit","schema":{"default":20,"maximum":50,"type":"integer"}}],"responses":{"200":{"description":"Cached multilingual news briefs with internal URLs."}},"summary":"Get multilingual Birkin market news"}},"/api/v1/recommend":{"get":{"operationId":"recommendBirkin","parameters":[{"in":"query","name":"budget","schema":{"type":"integer"}},{"in":"query","name":"use","schema":{"enum":["everyday","evening","investment","travel","gift","work"],"type":"string"}}],"responses":{"200":{"description":"Recommended specs and matching live listings."}},"summary":"Recommend a Birkin by budget and use case"}},"/data/api-directory.json":{"get":{"operationId":"getBirkinApiDirectory","responses":{"200":{"description":"Agent and CLI integration map."}},"summary":"Get API directory"}},"/feed.json":{"get":{"operationId":"getBirkinJsonFeed","responses":{"200":{"description":"JSON Feed v1.1 of recent BirkinBagStock content."}},"summary":"Get JSON Feed"}},"/source.json":{"get":{"operationId":"getBirkinSourcePack","responses":{"200":{"description":"Source pack for retrievers and data products."}},"summary":"Get source pack"}}},"servers":[{"url":"https://www.birkinbagstock.com"}]}