{"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=ko&limit=10","locales":["en","es","fr","de","it","pt","ja","zh","ko","nl","tr","ar"],"task":"Get multilingual Birkin news","use_when":"A bot, CLI, newsletter, or content pipeline needs current Birkin/luxury resale news across regions."},{"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","examples":"https://www.birkinbagstock.com/data/examples.json","json_feed":"https://www.birkinbagstock.com/feed.json","llms_full":"https://www.birkinbagstock.com/llms-full.txt","llms_full_well_known":"https://www.birkinbagstock.com/.well-known/llms-full.txt","llms_txt":"https://www.birkinbagstock.com/llms.txt","llms_txt_well_known":"https://www.birkinbagstock.com/.well-known/llms.txt","mcp_manifest":"https://www.birkinbagstock.com/mcp.json","mcp_manifest_well_known":"https://www.birkinbagstock.com/.well-known/mcp.json","openapi":"https://www.birkinbagstock.com/openapi.yaml","openapi_json":"https://www.birkinbagstock.com/openapi.json","openapi_json_well_known":"https://www.birkinbagstock.com/.well-known/openapi.json","openapi_well_known":"https://www.birkinbagstock.com/.well-known/openapi.yaml","postman_collection":"https://www.birkinbagstock.com/data/postman-collection.json","prompt_txt":"https://www.birkinbagstock.com/prompt.txt","source_pack":"https://www.birkinbagstock.com/source.json","source_pack_well_known":"https://www.birkinbagstock.com/.well-known/source.json","vibecoder_brief":"https://www.birkinbagstock.com/vibecoders.txt","vibecoder_prompt_markdown":"https://www.birkinbagstock.com/prompts/birkinbagstock.md"},"formats":["json","yaml","text","html","iframe","javascript"],"generated_at":"2026-05-14T04:14:51.742694+00:00","homepage":"https://www.birkinbagstock.com","name":"BirkinBagStock","news_locales":["en","es","fr","de","it","pt","ja","zh","ko","nl","tr","ar"]}