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.

★ Start here · MCP Server

Add BirkinBagStock to Claude, Cursor, or any MCP client in one line

MCP 1.2.0 · 12 read-only research tools for listings, asking prices, trends, checklists, reports, auctions and directories. No API key. Listing results link to BirkinBagStock research pages. The MCP does not create alerts or return purchase links. BirkinBagStock is an independent price index; some merchant links on our pages may be affiliate links.

{ "mcpServers": { "birkinbagstock": { "url": "https://birkinbagstock.com/mcp" } } }

Server capabilities → Tool reference → JSON manifest

MCP 1.2.0 tool reference (12 read-only tools)

get_hermes_resale_report — Monthly Hermès resale report: Read a fixed monthly research report from BirkinBagStock, including source URL, cutoff, cohort size, method and caveats. Reseller asking prices are not completed sales or a guaranteed valuation.
list_hermes_auctions — Hermès auction calendar: Read indexed auction sales containing Hermès lots, with dates, catalogue source links and recorded lot counts. Coverage is a sample; sale details can change at the auction house.
get_hermes_auction_results — Hermès auction results: Read recorded Hermès auction results with original-currency prices, price basis, check dates and auction-house source links. Hammer and premium-inclusive results differ; coverage is a sample.
list_birkin_resellers — Indexed Hermès resellers: Read reseller names, regions and indexed available-listing counts from BirkinBagStock. Counts reflect scheduled source checks; inclusion is not an endorsement.
find_hermes_care_services — Hermès care service directory: Read the independent directory of handbag care and accessory providers by country and category. Directory inclusion does not certify quality or authenticity; this tool does not book or pay for services.
search_birkin — Search Birkin asking prices: Search the indexed Birkin catalogue by specifications and USD asking-price budget. Returns at most 10 listing pages with seller names. Data reflects scheduled source checks, not guaranteed availability; BirkinBagStock does not authenticate bags.
get_market_price — Birkin asking-price statistics: Calculate USD asking-price statistics for matching indexed Birkin listings. Includes sample and priced-listing counts when available. These are seller offers, not completed sales, authentication or a guaranteed appraisal.
compare_listings — Compare Birkin listings: Compare the recorded specifications and USD asking prices of two or three distinct listing IDs. Price-on-request listings may have no numeric price; the lowest recorded ask is not a quality or authenticity recommendation.
get_price_trend — Birkin asking-price history: Read daily indexed median-ask snapshots for an existing Birkin specification over 7–90 days. May return insufficient_data or no_landing. Changing samples affect trends; historical asks do not predict returns or future prices.
list_market_movers — Birkin median-ask changes: Read specifications with the largest recorded median-ask percentage changes over 2–30 days in the indexed snapshot history. Limited or changing samples may yield insufficient_data; changes are not investment forecasts.
list_popular_specs — Popular indexed Birkin specifications: Read frequently requested specification pages with recorded match counts. Popularity reflects BirkinBagStock page requests, not market-wide sales or demand. Returns at most 12 specification pages.
get_authentication_signals — Birkin inspection reference: Read a curated inspection checklist, recorded blind-stamp year references and leather notes. Educational reference only: no photographs are analyzed and no individual bag is certified authentic or counterfeit.

Privacy · Terms · Support

The separate REST API supports price-alert signup at POST /api/v1/alerts and buy-URL resolution at GET /api/v1/buy/{listing_id}.

6047Live listings

127Merchants indexed

JSONNo auth for reads

OpenAPIAgent-ready

Open data (CC BY 4.0): monthly CSV snapshots of asking prices by model, size and leather at github.com/softdevfz/hermes-resale-index.

Fast Starts

Search Inventory

Filter by size, color, leather, condition, budget, merchant, and sort order.

Open JSON example

Best Value Feed

AI-ranked Birkin listings priced below their typical market range.

Open best-value JSON

Price Snapshot

Live Birkin resale price today: median, lowest ask, range, and category medians.

Open price JSON

Fresh Inventory Feeds

Track newly discovered products, source health, and the last successful catalog refresh.

New arrivals Freshness

Matched Price Appreciation

Same-listing time series that separates price movement from changes in inventory mix.

Open appreciation index

Multilingual News

Fresh Birkin/luxury resale headlines across 12 languages, including Korean, Dutch, Turkish, and Arabic.

Open news JSON

News Locale Index

Language map with crawlable news pages, API URLs, hreflang URLs, and recent examples for agents and feeds.

Open locale index

LLM Source Manifest

Small source rules, endpoint map, attribution guidance, and copy-paste snippets for agents and coding tools.

Open LLM source JSON

Spec Index

Grouped commercial Birkin landing pages by merchant, budget, size, color, leather, and hardware.

Open spec-index JSON

Birkin Alternatives

Resolve a popular Birkin spec and return comparable profiles with live medians, depth, rationale, and URLs.

Open alternatives JSON

Listing Alternatives

Start from one live listing and return cheaper close matches, similar bags, cohort stats, and spec alternative context.

Open listing alternatives JSON

Source Pages

Crawlable HTML and JSON source maps for listings, sponsored search pages, content, comparisons, and data endpoints.

Open source pages

Source Pack

Compact integration context for retrievers, data products, notebooks, dashboards, and internal research tools.

Open source pack

Canonical 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.

Alternatives search endpoint Alternatives index JSON Alternatives hub

Birkin 30 Gold Togo

The classic everyday resale benchmark: warm neutral, durable leather, and practical capacity.

HTML JSON

Birkin 30 Black Togo

A low-risk first Birkin profile with broad outfit range and strong resale liquidity.

HTML JSON

Birkin 25 Black Togo

Compact, evening-friendly, and highly liquid for buyers who prioritize scarcity and silhouette.

HTML JSON

Birkin 25 Gold Epsom

Structured, compact, and highly giftable with a classic Hermès color lane.

HTML JSON

Birkin 30 Etoupe Togo

A quiet neutral alternative to Black or Gold with strong day-to-day versatility.

HTML JSON

Birkin 25 Etoupe Epsom

Compact, structured, and neutral for buyers who want a sharper profile than Togo.

HTML JSON

Birkin 35 Gold Togo

A value-oriented work and travel size with classic color appeal.

HTML JSON

Birkin 35 Black Clemence

A softer, practical value route for buyers who want capacity and a classic color.

HTML JSON

Birkin 30 Craie Epsom

A bright neutral statement with structured leather and strong visual contrast.

HTML JSON

Birkin 30 Etain Togo

A grey-neutral path for buyers who want quieter color than Gold and less starkness than Black.

HTML JSON

Birkin 25 Rose Sakura Epsom

A collectible pastel lane where size, condition, and color rarity drive premium.

HTML JSON

Birkin 30 Bleu Nuit Togo

A dark-color alternative to Black with more personality and similar everyday usability.

HTML JSON

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.