{"attribution":{"link":"https://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","repository":"https://github.com/softdevfz/birkinbagstock-mcp"},"auth":"No auth required for public read endpoints. Partner/admin endpoints are excluded.","copy_paste":{"curl_alternatives":"curl -s 'https://birkinbagstock.com/api/v1/alternatives/search?q=Birkin%2030%20Gold%20Togo&limit=8'","curl_best_value":"curl -s 'https://birkinbagstock.com/data/best-value-birkins.json'","curl_black_30_under_30k":"curl -s 'https://birkinbagstock.com/api/v1/inventory?size=30&color=Black&max_price=30000&limit=10'","curl_dataset_metadata":"curl -s 'https://birkinbagstock.com/data/dataset-metadata.json'","curl_listing_alternatives":"curl -s 'https://birkinbagstock.com/api/v1/listing/fp-1840027/alternatives?limit=6'","curl_listing_price_history":"curl -s 'https://birkinbagstock.com/data/listing-price-history/fp-1840027.json'","curl_matched_index":"curl -s 'https://birkinbagstock.com/data/birkin-price-appreciation-index.json'","curl_source_index":"curl -s 'https://birkinbagstock.com/data/source-index.json'","curl_spec_price_history":"curl -s 'https://birkinbagstock.com/data/price-history/birkin-30-gold-togo.json'","javascript":"const r = await fetch('https://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 })));","javascript_alternatives":"const r = await fetch('https://birkinbagstock.com/api/v1/alternatives/search?q=Birkin%2030%20Gold%20Togo&limit=8');\nconst data = await r.json();\nconsole.table(data.alternatives.map(x => ({ spec: x.reference.label, score: x.score, median: x.listing_stats.median_label })));","javascript_listing_alternatives":"const r = await fetch('https://birkinbagstock.com/api/v1/listing/fp-1840027/alternatives?limit=6');\nconst data = await r.json();\nconsole.table(data.lower_priced.concat(data.similar_listings).map(x => ({ title: x.title, price: x.price, merchant: x.merchant, url: x.detail_url })));","jq_titles":"curl -s 'https://birkinbagstock.com/api/v1/inventory?limit=5' | jq -r '.results[] | [.title, .price, .merchant, .buy_url] | @tsv'","python":"import requests\nr = requests.get('https://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://birkinbagstock.com/api/v1/inventory","example":"https://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://birkinbagstock.com/api/v1/buy/{listing_id}","example":"https://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://birkinbagstock.com/api/v1/listing/{listing_id}","example":"https://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://birkinbagstock.com/api/v1/listing/{listing_id}/alternatives","example":"https://birkinbagstock.com/api/v1/listing/fp-1840027/alternatives?limit=6","task":"Compare alternatives for a listing","use_when":"A buyer is viewing one bag and needs cheaper close matches, similar listings, and canonical spec alternatives before checkout."},{"endpoint":"https://birkinbagstock.com/api/v1/recommend","example":"https://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://birkinbagstock.com/data/hermes-birkin-price-today.json","example":"https://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://birkinbagstock.com/data/birkin-price-appreciation-index.json","example":"https://birkinbagstock.com/data/birkin-price-appreciation-index.json","html_report":"https://birkinbagstock.com/reports/birkin-resale-price-index-2026","task":"Get matched repeat-listing price index","use_when":"A journalist, model, or analyst needs a same-SKU Birkin price index that is not distorted by inventory mix changes."},{"endpoint":"https://birkinbagstock.com/data/price-history/{spec_slug}.json","example":"https://birkinbagstock.com/data/price-history/birkin-30-gold-togo.json","html_page":"https://birkinbagstock.com/price-history/birkin-30-gold-togo","task":"Get spec-level price history","use_when":"A buyer, article, or agent needs median asking-price movement for a specific Birkin spec."},{"endpoint":"https://birkinbagstock.com/data/listing-price-history/{listing_id}.json","example":"https://birkinbagstock.com/data/listing-price-history/fp-1840027.json","task":"Get listing-level price history","use_when":"A buyer or agent needs observed price cuts/increases for one live listing."},{"endpoint":"https://birkinbagstock.com/data/dataset-metadata.json","example":"https://birkinbagstock.com/data/dataset-metadata.json","repository":"https://github.com/softdevfz/birkinbagstock-mcp","task":"Get dataset metadata","use_when":"A registry, dataset mirror, crawler, or citation tool needs license, schema, distribution URLs, and citation text."},{"endpoint":"https://birkinbagstock.com/data/best-value-birkins.json","example":"https://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://birkinbagstock.com/api/v1/news","example":"https://birkinbagstock.com/api/v1/news?locale=ko&limit=10","index":"https://birkinbagstock.com/data/news-locales.json","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://birkinbagstock.com/data/merchant-performance-reports.json","example":"https://birkinbagstock.com/data/merchant-performance-reports.json?days=30","html_index":"https://birkinbagstock.com/merchant-performance","task":"Get merchant performance reports","use_when":"A partner, analyst, or outreach workflow needs public merchant demand data."},{"endpoint":"https://birkinbagstock.com/data/spec-index.json","example":"https://birkinbagstock.com/data/spec-index.json","task":"Get high-intent spec pages","use_when":"A CLI, agent, crawler, or app needs a grouped map of commercial Birkin landing pages."},{"endpoint":"https://birkinbagstock.com/api/v1/alternatives/search","example":"https://birkinbagstock.com/api/v1/alternatives/search?q=Birkin%2030%20Gold%20Togo&limit=8","html_index":"https://birkinbagstock.com/alternatives","task":"Compare Birkin alternatives by spec","use_when":"A buyer asks for alternatives to a specific Birkin size, color, or leather profile."},{"endpoint":"https://birkinbagstock.com/data/source-index.json","example":"https://birkinbagstock.com/data/source-index.json","html_index":"https://birkinbagstock.com/source-pages","task":"Discover crawlable source pages","use_when":"A crawler, retriever, CLI, or vibe-coded app needs an exhaustive map of source pages, listing directories, content, and data endpoints."}],"description":"Live Herm\u00e8s Birkin inventory, pricing, news, resale-market data, and merchant performance feeds.","discovery":{"academy":"https://birkinbagstock.com/academy","agents":"https://birkinbagstock.com/agents.json","ai_plugin":"https://birkinbagstock.com/.well-known/ai-plugin.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","birkin_alternatives_search":"https://birkinbagstock.com/api/v1/alternatives/search?q=Birkin%2030%20Gold%20Togo&limit=8","buyer_tools":"https://birkinbagstock.com/tools","cli_examples":"https://birkinbagstock.com/cli.txt","datapackage":"https://birkinbagstock.com/datapackage.json","dataset_card":"https://birkinbagstock.com/data/dataset-card.md","dataset_metadata":"https://birkinbagstock.com/data/dataset-metadata.json","examples":"https://birkinbagstock.com/data/examples.json","json_feed":"https://birkinbagstock.com/feed.json","listing_alternatives":"https://birkinbagstock.com/api/v1/listing/fp-1840027/alternatives","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_full_well_known":"https://birkinbagstock.com/.well-known/llms-full.txt","llms_txt":"https://birkinbagstock.com/llms.txt","llms_txt_well_known":"https://birkinbagstock.com/.well-known/llms.txt","matchmaker":"https://birkinbagstock.com/matchmaker","mcp_manifest":"https://birkinbagstock.com/mcp.json","mcp_manifest_well_known":"https://birkinbagstock.com/.well-known/mcp.json","merchant_performance_index":"https://birkinbagstock.com/merchant-performance","news_locales_index":"https://birkinbagstock.com/data/news-locales.json","openapi":"https://birkinbagstock.com/openapi.yaml","openapi_json":"https://birkinbagstock.com/openapi.json","openapi_json_well_known":"https://birkinbagstock.com/.well-known/openapi.json","openapi_well_known":"https://birkinbagstock.com/.well-known/openapi.yaml","postman_collection":"https://birkinbagstock.com/data/postman-collection.json","prompt_txt":"https://birkinbagstock.com/prompt.txt","public_github_repo":"https://github.com/softdevfz/birkinbagstock-mcp","source_index":"https://birkinbagstock.com/data/source-index.json","source_index_well_known":"https://birkinbagstock.com/.well-known/source-index.json","source_pack":"https://birkinbagstock.com/source.json","source_pack_well_known":"https://birkinbagstock.com/.well-known/source.json","source_pages":"https://birkinbagstock.com/source-pages","spec_index":"https://birkinbagstock.com/data/spec-index.json","vibecoder_brief":"https://birkinbagstock.com/vibecoders.txt","vibecoder_prompt_markdown":"https://birkinbagstock.com/prompts/birkinbagstock.md"},"formats":["json","yaml","text","html","iframe","javascript"],"generated_at":"2026-08-17T13:43:38.815161+00:00","homepage":"https://birkinbagstock.com","name":"BirkinBagStock","news_locales":["en","es","fr","de","it","pt","ja","zh","ko","nl","tr","ar"]}