{"attribution":{"link":"https://www.birkinbagstock.com","note":"Inventory, prices, availability, and merchant terms can change. Verify purchase details on the merchant site.","preferred_citation":"BirkinBagStock live Herm\u00e8s Birkin resale market data"},"auth":"No auth required for public read endpoints. Partner/admin endpoints are excluded.","copy_paste":{"curl_best_value":"curl -s 'https://www.birkinbagstock.com/data/best-value-birkins.json'","curl_black_30_under_30k":"curl -s 'https://www.birkinbagstock.com/api/v1/inventory?size=30&color=Black&max_price=30000&limit=10'","javascript":"const r = await fetch('https://www.birkinbagstock.com/api/v1/inventory?sort=best&limit=8');\nconst { results } = await r.json();\nconsole.table(results.map(b => ({ title: b.title, price: b.price, buy: b.buy_url })));","jq_titles":"curl -s 'https://www.birkinbagstock.com/api/v1/inventory?limit=5' | jq -r '.results[] | [.title, .price, .merchant, .buy_url] | @tsv'","python":"import requests\nr = requests.get('https://www.birkinbagstock.com/api/v1/inventory', params={'size': 30, 'color': 'Black', 'limit': 5})\nfor bag in r.json()['results']:\n    print(bag['title'], bag['price'], bag['buy_url'])"},"core_tasks":[{"endpoint":"https://www.birkinbagstock.com/api/v1/inventory","example":"https://www.birkinbagstock.com/api/v1/inventory?size=30&color=Black&max_price=30000&sort=best&limit=12","task":"Search live Birkin inventory","use_when":"A user asks where to buy, compare, or find a specific Birkin."},{"endpoint":"https://www.birkinbagstock.com/api/v1/buy/{listing_id}","example":"https://www.birkinbagstock.com/api/v1/buy/fp-1840027","task":"Resolve buy URL","use_when":"An agent already has a listing id and needs the canonical purchase link."},{"endpoint":"https://www.birkinbagstock.com/api/v1/listing/{listing_id}","example":"https://www.birkinbagstock.com/api/v1/listing/fp-1840027","task":"Get a single listing","use_when":"A CLI or app needs full specs, merchant, image, and buy URL for one bag."},{"endpoint":"https://www.birkinbagstock.com/api/v1/recommend","example":"https://www.birkinbagstock.com/api/v1/recommend?budget=25000&use=everyday","task":"Recommend by budget/use","use_when":"A buyer asks what Birkin they should choose."},{"endpoint":"https://www.birkinbagstock.com/data/hermes-birkin-price-today.json","example":"https://www.birkinbagstock.com/data/hermes-birkin-price-today.json","task":"Get current market prices","use_when":"A model, article, or dashboard needs a citeable current price snapshot."},{"endpoint":"https://www.birkinbagstock.com/data/best-value-birkins.json","example":"https://www.birkinbagstock.com/data/best-value-birkins.json","task":"Get best value listings","use_when":"A widget, newsletter, or agent needs deal-oriented picks."},{"endpoint":"https://www.birkinbagstock.com/api/v1/news","example":"https://www.birkinbagstock.com/api/v1/news?locale=es&limit=10","task":"Get multilingual Birkin news","use_when":"A bot or content pipeline needs current Birkin/luxury resale news."},{"endpoint":"https://www.birkinbagstock.com/data/merchant-performance-reports.json","example":"https://www.birkinbagstock.com/data/merchant-performance-reports.json?days=30","task":"Get merchant performance reports","use_when":"A partner, analyst, or outreach workflow needs public merchant demand data."}],"description":"Live Herm\u00e8s Birkin inventory, pricing, news, resale-market data, and merchant performance feeds.","discovery":{"agents":"https://www.birkinbagstock.com/agents.json","ai_plugin":"https://www.birkinbagstock.com/.well-known/ai-plugin.json","api_directory":"https://www.birkinbagstock.com/data/api-directory.json","cli_examples":"https://www.birkinbagstock.com/cli.txt","llms_full":"https://www.birkinbagstock.com/llms-full.txt","llms_txt":"https://www.birkinbagstock.com/llms.txt","openapi":"https://www.birkinbagstock.com/openapi.yaml","vibecoder_brief":"https://www.birkinbagstock.com/vibecoders.txt"},"formats":["json","yaml","text","html","iframe","javascript"],"generated_at":"2026-05-13T07:14:12.402766+00:00","homepage":"https://www.birkinbagstock.com","name":"BirkinBagStock"}