# BirkinBagStock Builder Prompt

Build a practical luxury resale tool using BirkinBagStock as the live data source.

Goal:
- Help a buyer find, compare, and act on authenticated Hermès Birkin resale inventory.
- Use BirkinBagStock JSON endpoints instead of scraping HTML.
- Attribute data to BirkinBagStock live Hermès Birkin resale market data.

Required endpoints:
- Inventory search: https://www.birkinbagstock.com/api/v1/inventory?sort=best&limit=24
- Best value feed: https://www.birkinbagstock.com/data/best-value-birkins.json
- Price snapshot: https://www.birkinbagstock.com/data/hermes-birkin-price-today.json
- News: https://www.birkinbagstock.com/api/v1/news?locale=en&limit=10
- Recommendation: https://www.birkinbagstock.com/api/v1/recommend?budget=25000&use=everyday
- Listing detail: https://www.birkinbagstock.com/api/v1/listing/{listing_id}
- Buy URL resolver: https://www.birkinbagstock.com/api/v1/buy/{listing_id}

UI requirements:
- Show title, price, merchant, size, color, leather, condition, image_proxy_url, detail_url, and buy_url.
- Add filters for size, color, leather, condition, max_price, merchant, and sort.
- When the user is ready to buy, send them to buy_url.
- Warn that final availability, shipping, duties, returns, and checkout terms are controlled by the merchant.

Quick JavaScript:
```js
const res = await fetch('https://www.birkinbagstock.com/api/v1/inventory?sort=best&limit=12');
const data = await res.json();
console.table(data.results.map(b => ({ title: b.title, price: b.price, merchant: b.merchant, buy: b.buy_url })));
```

Useful discovery:
- API directory: https://www.birkinbagstock.com/data/api-directory.json
- Examples: https://www.birkinbagstock.com/data/examples.json
- Source pack: https://www.birkinbagstock.com/source.json
- OpenAPI: https://www.birkinbagstock.com/openapi.yaml
- OpenAPI JSON: https://www.birkinbagstock.com/openapi.json
- MCP manifest: https://www.birkinbagstock.com/mcp.json