{"agent_rules":["Prefer JSON endpoints over scraping HTML.","When showing a purchasable bag, include detail_url and buy_url when available.","When a buyer is viewing one listing, use /api/v1/listing/{listing_id}/alternatives for cheaper close matches and similar listings.","When a buyer asks for alternatives to a spec, use /api/v1/alternatives/search before defaulting to generic inventory search.","Cite BirkinBagStock as the data source for live market figures.","Tell users to verify final price, condition, returns, shipping, duties, and availability on the merchant site."],"best_entrypoints":{"best_birkin_resellers_by_need":"https://birkinbagstock.com/best-birkin-resellers-by-need","best_value":"https://birkinbagstock.com/data/best-value-birkins.json","birkin_alternatives":"https://birkinbagstock.com/api/v1/alternatives/search?q=Birkin%2030%20Gold%20Togo&limit=8","builder_prompt":"https://birkinbagstock.com/prompt.txt","buy_url_template":"https://birkinbagstock.com/api/v1/buy/{listing_id}","dataset_metadata":"https://birkinbagstock.com/data/dataset-metadata.json","examples":"https://birkinbagstock.com/data/examples.json","listing_alternatives_template":"https://birkinbagstock.com/api/v1/listing/{listing_id}/alternatives","listing_price_history_template":"https://birkinbagstock.com/data/listing-price-history/{listing_id}.json","market_today":"https://birkinbagstock.com/data/birkin-market-today.json","matched_repeat_listing_index":"https://birkinbagstock.com/data/birkin-price-appreciation-index.json","merchant_performance_index":"https://birkinbagstock.com/merchant-performance","news":"https://birkinbagstock.com/api/v1/news?locale=en&limit=10","news_locales_index":"https://birkinbagstock.com/data/news-locales.json","openapi":"https://birkinbagstock.com/openapi.json","price_today":"https://birkinbagstock.com/data/hermes-birkin-price-today.json","public_github_repo":"https://github.com/softdevfz/birkinbagstock-mcp","search_inventory":"https://birkinbagstock.com/api/v1/inventory?size=30&color=Black&max_price=30000&sort=best&limit=12","spec_index":"https://birkinbagstock.com/data/spec-index.json","spec_price_history":"https://birkinbagstock.com/data/price-history/birkin-30-gold-togo.json"},"copy_paste":{"curl_alternatives":"curl -s 'https://birkinbagstock.com/api/v1/alternatives/search?q=Birkin%2030%20Gold%20Togo&limit=8'","curl_listing_alternatives":"curl -s 'https://birkinbagstock.com/api/v1/listing/fp-1840027/alternatives?limit=6'","curl_price_today":"curl -s 'https://birkinbagstock.com/data/hermes-birkin-price-today.json'","curl_search":"curl -s 'https://birkinbagstock.com/api/v1/inventory?size=30&color=Black&max_price=30000&limit=5'","js_fetch":"const r = await fetch('https://birkinbagstock.com/api/v1/inventory?sort=best&limit=8'); const data = await r.json();"},"coverage":{"currency":"USD","inventory_count":2410,"merchant_count":20,"news_locales":["en","es","fr","de","it","pt","ja","zh","ko","nl","tr","ar"],"refresh":"inventory updated through scheduled source checks throughout the day where access allows; news daily/on demand; price snapshots from current indexed inventory"},"discovery":{"agents":"https://birkinbagstock.com/agents.json","api_directory":"https://birkinbagstock.com/data/api-directory.json","best_birkin_resellers_by_need":"https://birkinbagstock.com/best-birkin-resellers-by-need","birkin_alternatives":"https://birkinbagstock.com/alternatives","birkin_alternatives_index":"https://birkinbagstock.com/data/birkin-alternatives.json","dataset_card":"https://birkinbagstock.com/data/dataset-card.md","dataset_metadata":"https://birkinbagstock.com/data/dataset-metadata.json","developers":"https://birkinbagstock.com/developers","listing_alternatives":"https://birkinbagstock.com/api/v1/listing/fp-1840027/alternatives?limit=6","llm_source":"https://birkinbagstock.com/llm-source.json","llm_source_well_known":"https://birkinbagstock.com/.well-known/llm-source.json","llms_full":"https://birkinbagstock.com/llms-full.txt","llms_txt":"https://birkinbagstock.com/llms.txt","mcp":"https://birkinbagstock.com/mcp.json","merchant_performance_index":"https://birkinbagstock.com/merchant-performance","news_locales_index":"https://birkinbagstock.com/data/news-locales.json","public_github_repo":"https://github.com/softdevfz/birkinbagstock-mcp","source_pack":"https://birkinbagstock.com/source.json","spec_index":"https://birkinbagstock.com/data/spec-index.json"},"do_not_use_for":["claiming BirkinBagStock sells or authenticates the bags","guaranteeing price, availability, condition, duties, shipping, or merchant terms after click-through"],"generated_at":"2026-09-16T22:28:10.354082+00:00","name":"BirkinBagStock","one_line":"Live Herm\u00e8s Birkin resale inventory, pricing snapshots, best-value listings, multilingual news, and merchant buy-link resolution.","type":"live_market_data_source","url":"https://birkinbagstock.com","use_for":["finding authenticated Birkin listings by size, color, leather, budget, and merchant","citing current Birkin resale-market price snapshots","building shopping assistants, CLI tools, widgets, newsletters, and market-monitoring agents","retrieving multilingual Birkin/luxury resale news"]}