Birkin Data For APIs, CLIs, Agents, and Builders
BirkinBagStock exposes live authenticated Hermès Birkin inventory, price snapshots, best-value picks, multilingual news, and merchant performance feeds in simple public formats.
{ "mcpServers": { "birkinbagstock": { "url": "https://birkinbagstock.com/mcp" } } }
Fast Starts
Search Inventory
Filter by size, color, leather, condition, budget, merchant, and sort order.
Open JSON exampleBest Value Feed
AI-ranked Birkin listings priced below their typical market range.
Open best-value JSONPrice Snapshot
Live Birkin resale price today: median, lowest ask, range, and category medians.
Open price JSONMultilingual News
Fresh Birkin/luxury resale headlines across 12 languages, including Korean, Dutch, Turkish, and Arabic.
Open news JSONNews Locale Index
Language map with crawlable news pages, API URLs, hreflang URLs, and recent examples for agents and feeds.
Open locale indexLLM Source Manifest
Small source rules, endpoint map, attribution guidance, and copy-paste snippets for agents and coding tools.
Open LLM source JSONSpec Index
Grouped commercial Birkin landing pages by merchant, budget, size, color, leather, and hardware.
Open spec-index JSONBirkin Alternatives
Resolve a popular Birkin spec and return comparable profiles with live medians, depth, rationale, and URLs.
Open alternatives JSONListing Alternatives
Start from one live listing and return cheaper close matches, similar bags, cohort stats, and spec alternative context.
Open listing alternatives JSONSource Pages
Crawlable HTML and JSON source maps for listings, sponsored search pages, content, comparisons, and data endpoints.
Open source pagesSource Pack
Compact integration context for retrievers, data products, notebooks, dashboards, and internal research tools.
Open source packCanonical Alternatives
Direct HTML and JSON routes for canonical Birkin spec alternatives. Use these when an app or agent needs comparable specs instead of generic inventory search.
Birkin 30 Gold Togo
The classic everyday resale benchmark: warm neutral, durable leather, and practical capacity.
Birkin 30 Black Togo
A low-risk first Birkin profile with broad outfit range and strong resale liquidity.
Birkin 25 Black Togo
Compact, evening-friendly, and highly liquid for buyers who prioritize scarcity and silhouette.
Birkin 25 Gold Epsom
Structured, compact, and highly giftable with a classic Hermès color lane.
Birkin 30 Etoupe Togo
A quiet neutral alternative to Black or Gold with strong day-to-day versatility.
Birkin 25 Etoupe Epsom
Compact, structured, and neutral for buyers who want a sharper profile than Togo.
Birkin 35 Black Clemence
A softer, practical value route for buyers who want capacity and a classic color.
Birkin 30 Craie Epsom
A bright neutral statement with structured leather and strong visual contrast.
Birkin 30 Etain Togo
A grey-neutral path for buyers who want quieter color than Gold and less starkness than Black.
Birkin 25 Rose Sakura Epsom
A collectible pastel lane where size, condition, and color rarity drive premium.
Copy-Paste CLI
curl -s 'https://birkinbagstock.com/api/v1/inventory?size=30&color=Black&max_price=30000&limit=10' curl -s 'https://birkinbagstock.com/api/v1/inventory?limit=5' \ | jq -r '.results[] | [.title, .price, .merchant, .buy_url] | @tsv' curl -s 'https://birkinbagstock.com/data/best-value-birkins.json' curl -s 'https://birkinbagstock.com/openapi.json' | jq '.paths | keys' curl -s 'https://birkinbagstock.com/data/source-index.json' | jq -r '.groups[] | [.slug, .item_count, .page_count, .href] | @tsv' curl -s 'https://birkinbagstock.com/data/spec-index.json' | jq -r '.links[] | [.group, .label, .url] | @tsv' | head curl -s 'https://birkinbagstock.com/api/v1/alternatives/search?q=Birkin%2030%20Gold%20Togo&limit=8' curl -s 'https://birkinbagstock.com/api/v1/listing/fp-1840027/alternatives?limit=6' curl -s 'https://birkinbagstock.com/data/news-locales.json' | jq -r '.locales[] | [.code, .label, .api_url, .html_url] | @tsv' curl -s 'https://birkinbagstock.com/feed.json' | jq -r '.items[].title' | head
Core Endpoints
| Task | Endpoint | Use When |
|---|---|---|
| Search live Birkin inventory | https://birkinbagstock.com/api/v1/inventory |
A user asks where to buy, compare, or find a specific Birkin. |
| Resolve buy URL | https://birkinbagstock.com/api/v1/buy/{listing_id} |
An agent already has a listing id and needs the canonical purchase link. |
| Get a single listing | https://birkinbagstock.com/api/v1/listing/{listing_id} |
A CLI or app needs full specs, merchant, image, and buy URL for one bag. |
| Compare alternatives for a listing | https://birkinbagstock.com/api/v1/listing/{listing_id}/alternatives |
A buyer is viewing one bag and needs cheaper close matches, similar listings, and canonical spec alternatives before checkout. |
| Recommend by budget/use | https://birkinbagstock.com/api/v1/recommend |
A buyer asks what Birkin they should choose. |
| Get current market prices | https://birkinbagstock.com/data/hermes-birkin-price-today.json |
A model, article, or dashboard needs a citeable current price snapshot. |
| Get matched repeat-listing price index | https://birkinbagstock.com/data/birkin-price-appreciation-index.json |
A journalist, model, or analyst needs a same-SKU Birkin price index that is not distorted by inventory mix changes. |
| Get spec-level price history | https://birkinbagstock.com/data/price-history/{spec_slug}.json |
A buyer, article, or agent needs median asking-price movement for a specific Birkin spec. |
| Get listing-level price history | https://birkinbagstock.com/data/listing-price-history/{listing_id}.json |
A buyer or agent needs observed price cuts/increases for one live listing. |
| Get dataset metadata | https://birkinbagstock.com/data/dataset-metadata.json |
A registry, dataset mirror, crawler, or citation tool needs license, schema, distribution URLs, and citation text. |
| Get best value listings | https://birkinbagstock.com/data/best-value-birkins.json |
A widget, newsletter, or agent needs deal-oriented picks. |
| Get multilingual Birkin news | https://birkinbagstock.com/api/v1/news |
A bot, CLI, newsletter, or content pipeline needs current Birkin/luxury resale news across regions. |
| Get merchant performance reports | https://birkinbagstock.com/data/merchant-performance-reports.json |
A partner, analyst, or outreach workflow needs public merchant demand data. |
| Get high-intent spec pages | https://birkinbagstock.com/data/spec-index.json |
A CLI, agent, crawler, or app needs a grouped map of commercial Birkin landing pages. |
| Compare Birkin alternatives by spec | https://birkinbagstock.com/api/v1/alternatives/search |
A buyer asks for alternatives to a specific Birkin size, color, or leather profile. |
| Discover crawlable source pages | https://birkinbagstock.com/data/source-index.json |
A crawler, retriever, CLI, or vibe-coded app needs an exhaustive map of source pages, listing directories, content, and data endpoints. |
Build Prompt
Build a clean luxury resale tool using BirkinBagStock public APIs.
Use https://birkinbagstock.com/api/v1/inventory?sort=best&limit=24 for live listings.
Use https://birkinbagstock.com/data/best-value-birkins.json for deal picks.
Use https://birkinbagstock.com/data/hermes-birkin-price-today.json for market price cards.
Use https://birkinbagstock.com/api/v1/alternatives/search?q=Birkin%2030%20Gold%20Togo&limit=8 when the user asks for comparable specs.
Use https://birkinbagstock.com/api/v1/listing/{listing_id}/alternatives when the user is deciding on one bag and wants cheaper or similar options.
Show title, price, size, color, leather, merchant, image_proxy_url, detail_url, and buy_url.
When the user wants to purchase, send them to buy_url.
Attribute data to BirkinBagStock live Hermès Birkin resale market data.