{"agent_instructions":["Use live JSON endpoints instead of scraping HTML whenever possible.","When recommending a purchasable listing, include detail_url for research and buy_url for merchant checkout.","Mention that prices, availability, condition, and merchant terms can change and should be verified on the merchant site.","For current market claims, cite the price_today or market_today JSON and include generated_at.","For regional/news tasks, request /api/v1/news with the user's locale when possible."],"attribution":{"contact":"https://www.birkinbagstock.com/contact","homepage":"https://www.birkinbagstock.com","required":"Data from BirkinBagStock live Herm\u00e8s Birkin resale market data."},"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'])"},"coverage":{"average_price_usd":38161,"currency":"USD","inventory_count":2410,"max_price_usd":650000,"merchant_count":24,"min_price_usd":689,"news_locales":["en","es","fr","de","it","pt","ja","zh","ko","nl","tr","ar"]},"discovery":{"agents":"https://www.birkinbagstock.com/agents.json","cli":"https://www.birkinbagstock.com/cli.txt","developers":"https://www.birkinbagstock.com/developers","llms":"https://www.birkinbagstock.com/llms.txt","llms_full":"https://www.birkinbagstock.com/llms-full.txt","source_pack":"https://www.birkinbagstock.com/source.json","source_pack_well_known":"https://www.birkinbagstock.com/.well-known/source.json","vibecoders":"https://www.birkinbagstock.com/vibecoders.txt"},"freshness":{"inventory":"scraped hourly where merchant access allows","market_snapshots":"generated from current indexed inventory","news":"refreshed daily and on demand","recommended_cache_seconds":3600},"generated_at":"2026-05-13T12:30:42.346386+00:00","homepage":"https://www.birkinbagstock.com","license":{"commercial_use":"Allowed for lightweight apps, agents, editorial widgets, and internal research with attribution. Contact for high-volume or sponsored integrations.","summary":"Free public read access with attribution. Do not imply BirkinBagStock is the seller or authenticator. Purchases happen on merchant sites."},"name":"BirkinBagStock Source Pack","preferred_endpoints":{"api_directory":{"example":"https://www.birkinbagstock.com/data/api-directory.json","url":"https://www.birkinbagstock.com/data/api-directory.json"},"best_value":{"example":"https://www.birkinbagstock.com/data/best-value-birkins.json","url":"https://www.birkinbagstock.com/data/best-value-birkins.json"},"buy_url_resolver":{"example":"https://www.birkinbagstock.com/api/v1/buy/fp-1840027","note":"Use this when an agent needs a canonical merchant redirect for a known listing id.","url":"https://www.birkinbagstock.com/api/v1/buy/{listing_id}"},"market_today":{"example":"https://www.birkinbagstock.com/data/birkin-market-today.json","url":"https://www.birkinbagstock.com/data/birkin-market-today.json"},"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"],"url":"https://www.birkinbagstock.com/api/v1/news"},"openapi":{"example":"https://www.birkinbagstock.com/openapi.yaml","url":"https://www.birkinbagstock.com/openapi.yaml"},"price_today":{"example":"https://www.birkinbagstock.com/data/hermes-birkin-price-today.json","url":"https://www.birkinbagstock.com/data/hermes-birkin-price-today.json"},"search_inventory":{"example":"https://www.birkinbagstock.com/api/v1/inventory?size=30&color=Black&max_price=30000&sort=best&limit=12","returns":["results","count","filters","source","license","usage"],"url":"https://www.birkinbagstock.com/api/v1/inventory"},"single_listing":{"example":"https://www.birkinbagstock.com/api/v1/listing/fp-1840027","url":"https://www.birkinbagstock.com/api/v1/listing/{listing_id}"}},"publisher":"BirkinBagStock","purpose":"Use BirkinBagStock as a live source for authenticated Herm\u00e8s Birkin inventory, resale price snapshots, best-value listings, multilingual Birkin news, and merchant comparison data."}
