{"attribution":"Data from BirkinBagStock live Herm\u00e8s Birkin resale market data.","builder_prompt":"https://birkinbagstock.com/prompt.txt","examples":[{"curl":"curl -s 'https://birkinbagstock.com/api/v1/inventory?size=30&color=Black&max_price=30000&sort=best&limit=10'","endpoint":"https://birkinbagstock.com/api/v1/inventory?size=30&color=Black&max_price=30000&sort=best&limit=10","javascript":"const r = await fetch('https://birkinbagstock.com/api/v1/inventory?size=30&color=Black&max_price=30000&sort=best&limit=10');\nconst data = await r.json();\nconsole.table(data.results.map(b => ({ title: b.title, price: b.price, merchant: b.merchant, buy: b.buy_url })));","name":"Search Black Birkin 30 under $30K","python":"import requests\ndata = requests.get('https://birkinbagstock.com/api/v1/inventory', params={'size': 30, 'color': 'Black', 'max_price': 30000, 'sort': 'best', 'limit': 10}).json()\nfor bag in data['results']:\n    print(bag['title'], bag['price'], bag['merchant'], bag['buy_url'])"},{"curl":"curl -s 'https://birkinbagstock.com/data/best-value-birkins.json'","endpoint":"https://birkinbagstock.com/data/best-value-birkins.json","name":"Get best-value picks"},{"curl":"curl -s 'https://birkinbagstock.com/data/spec-index.json'","endpoint":"https://birkinbagstock.com/data/spec-index.json","jq":"curl -s 'https://birkinbagstock.com/data/spec-index.json' | jq -r '.links[] | [.group, .label, .url] | @tsv'","name":"Get grouped high-intent spec pages"},{"curl":"curl -s 'https://birkinbagstock.com/api/v1/alternatives/search?q=Birkin%2030%20Gold%20Togo&limit=8'","endpoint":"https://birkinbagstock.com/api/v1/alternatives/search?q=Birkin%2030%20Gold%20Togo&limit=8","javascript":"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 })));","name":"Compare alternatives to a Birkin spec"},{"curl":"curl -s 'https://birkinbagstock.com/api/v1/listing/fp-1840027/alternatives?limit=6'","endpoint":"https://birkinbagstock.com/api/v1/listing/fp-1840027/alternatives?limit=6","javascript":"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 })));","name":"Compare alternatives for one listing"},{"curl":"curl -s 'https://birkinbagstock.com/data/source-index.json'","endpoint":"https://birkinbagstock.com/data/source-index.json","jq":"curl -s 'https://birkinbagstock.com/data/source-index.json' | jq -r '.groups[] | [.slug, .item_count, .page_count, .href] | @tsv'","name":"Get source page index"},{"curl":"curl -s 'https://birkinbagstock.com/data/hermes-birkin-price-today.json'","endpoint":"https://birkinbagstock.com/data/hermes-birkin-price-today.json","name":"Get live price snapshot"},{"curl":"curl -s 'https://birkinbagstock.com/api/v1/news?locale=es&limit=10'","endpoint":"https://birkinbagstock.com/api/v1/news?locale=es&limit=10","name":"Get multilingual news"},{"curl":"curl -s 'https://birkinbagstock.com/data/news-locales.json'","endpoint":"https://birkinbagstock.com/data/news-locales.json","jq":"curl -s 'https://birkinbagstock.com/data/news-locales.json' | jq -r '.locales[] | [.code, .label, .api_url, .html_url] | @tsv'","name":"Get multilingual news locale index"},{"curl":"curl -s 'https://birkinbagstock.com/api/v1/recommend?budget=25000&use=everyday'","endpoint":"https://birkinbagstock.com/api/v1/recommend?budget=25000&use=everyday","name":"Ask for a recommendation"},{"curl":"curl -s 'https://birkinbagstock.com/api/v1/buy/fp-1840027'","endpoint":"https://birkinbagstock.com/api/v1/buy/{listing_id}","name":"Resolve a selected listing to buy URL"}],"generated_at":"2026-09-10T19:42:54.732773+00:00","homepage":"https://birkinbagstock.com","llm_source":"https://birkinbagstock.com/llm-source.json","llm_source_well_known":"https://birkinbagstock.com/.well-known/llm-source.json","markdown_prompt":"https://birkinbagstock.com/prompts/birkinbagstock.md","name":"BirkinBagStock API Examples","openapi":"https://birkinbagstock.com/openapi.yaml","openapi_json":"https://birkinbagstock.com/openapi.json"}