BirkinBagStock

BirkinBagStock API

Search and compare merchant-listed pre-owned Hermès Birkin bags across luxury resellers. Inventory reflects the most recently observed merchant data.…

E-commerce#shopping

Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.

Overview

Search and compare merchant-listed pre-owned Hermès Birkin bags across luxury
resellers. Inventory reflects the most recently observed merchant data.
Authentication, current availability, buyer protection, shipping, and returns
remain merchant-provided claims that users should verify before purchase.
Prefer detail_url as the factual citation and present buy_url as a separate
merchant action when it is available.

Endpoints 30

  • GETGet API directory for agents, CLIs, and builders/data/api-directory.jsonReturns copy-paste examples, public endpoints, and integration guidance for using BirkinBagStock as a live Birkin market data source.
  • GETGet crawlable source page hub/source-pagesHTML hub that links to paginated source pages for listings, sponsored pages, content, comparisons, and machine-readable data endpoints.
  • GETGet machine-readable source page index/data/source-index.jsonReturns grouped source-page metadata for crawlers, retrievers, CLIs, agents, and builders.
  • GETGet well-known source page index/.well-known/source-index.jsonAlias of /data/source-index.json for tool registries, crawlers, agents, and retrievers that probe /.well-known discovery URLs.
  • GETGet grouped high-intent Birkin spec pages/data/spec-index.jsonReturns merchant, budget, size, color, leather, and hardware landing pages grouped for crawlers, CLIs, agents, and app navigation.
  • GETGet the current inventory citation dataset/data/current-inventory.jsonReturns the current public inventory snapshot with coverage metadata, observation timestamps, canonical detail URLs, and merchant action URLs.
  • GETGet newly observed and recently updated products/data/new-arrivals.jsonReturns the freshest current inventory rows, separated into new arrivals and recently updated listings.
  • GETGet source observation and verification health/api/v1/freshnessReturns scrape-run health and explicitly distinguishes observed sources from product-grade verified-complete snapshots.
  • GETGet dataset metadata/data/dataset-metadata.jsonSchema.org/DataPackage metadata for dataset mirrors, crawlers, and citation tools.
  • GETGet Frictionless Data Package/datapackage.json
  • GETGet markdown dataset card/data/dataset-card.md
  • GETGet matched repeat-listing price index/data/birkin-price-appreciation-index.json
  • GETGet spec-level price history/data/price-history/:spec_slug.json
  • GETGet listing-level price history/data/listing-price-history/:listing_id.json
  • GETGet Birkin alternatives profile index/data/birkin-alternatives.jsonReturns canonical Birkin alternative profiles with live listing stats and page/API URLs.
  • GETGet multilingual news locale index/data/news-locales.jsonReturns all supported Birkin news languages with API URLs, crawlable HTML pages, hreflang codes, and recent examples.
  • GETGet compact LLM source manifest/llm-source.jsonSmall, fast JSON manifest for ChatGPT, Claude, Codex, CLI tools, and vibecoders that need source rules, key endpoints, copy-paste snippets, and attribution…
  • GETGet agent discovery manifest/agents.jsonAlias of the API directory for AI agents and tool registries.
  • GETSearch Birkin bag inventory with filters/api/v1/inventoryReturns available Birkin bags. Use this when a user asks about buying, finding, or pricing Birkin bags.
  • GETResolve a listing to its buy URL (partner)/api/v1/buy/:idSingle-call resolver. Returns the canonical buy_url — a 302 redirect on our domain that forwards the user to the merchant listing with partner attribution…
  • GETGet personalized Birkin recommendations/api/v1/recommend?budget=0Returns ideal Birkin specs and matching inventory based on budget and intended use.
  • GETResolve a Birkin spec and return comparable alternatives/api/v1/alternatives/search?q=stringReturns a source Birkin profile, live cohort stats, ranked alternatives, rationale, URLs, and current listings.
  • GETGet alternatives for a canonical Birkin spec profile/api/v1/alternatives/:slug
  • GETLive observed Birkin asking-price guide/api/v1/price-guideReturns timestamped public inventory counts and observed asking-price statistics by size, plus clearly dated editorial reference ranges and methodology links.…
  • GETGet structured Birkin buyer comparisons/data/comparisons.jsonReturns comparison pages for common buyer decisions such as Birkin 25 vs 30, Togo vs Epsom, and Black vs Gold with live market stats.
  • GETGet multilingual Birkin market news/api/v1/newsReturns cached Birkin and luxury resale headlines with buyer-facing summaries. Supports 12 locales: en, es, fr, de, it, pt, ja, zh, ko, nl, tr, ar. Use this…
  • POSTCreate a Birkin price or inventory alert/api/v1/alertsStores an email alert for a requested Birkin size, color, leather, maximum price, or semantic buying intent. Use this when an agent, CLI, or shopping…
  • POSTIdempotently sync wishlist price-drop alerts/api/v1/wishlistCreates or updates one exact-listing price-drop alert per email profile and listing ID. Listing price and specifications are hydrated server-side; repeated…
  • GETGet details for a specific Birkin listing/api/v1/listing/:id
  • GETGet alternatives for a specific Birkin listing/api/v1/listing/:id/alternativesReturns lower-priced close matches, similar listings, cohort stats, and canonical spec alternative context for one listing.

API details

Base URL
https://birkinbagstock.com
Authentication
None declared in the description
Operations
30 operations on 30 pathsGET 28POST 2
Response formats
application/json
Description format
OpenAPI 3.1.0, API version 1.0.0

How to test the BirkinBagStock API in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the BirkinBagStock API collection, without the publisher's secrets.
  3. Add your credentialsOpen the collection's variables or an environment and enter your API key or token, if the API needs one.
  4. Send a requestPick an endpoint, for example “Get API directory for agents, CLIs, and builders” (GET /data/api-directory.json), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the BirkinBagStock API?

Search and compare merchant-listed pre-owned Hermès Birkin bags across luxury resellers. Inventory reflects the most recently observed merchant data.… It is listed under E-commerce and has 30 endpoints.

Who publishes the BirkinBagStock API?

It is listed from BirkinBagStock's public API description (an OpenAPI document), not published by BirkinBagStock on Swastik Codes. Anyone who controls birkinbagstock.com can claim the profile by adding a DNS TXT record.

What is the base URL of the BirkinBagStock API?

Requests go to https://birkinbagstock.com. Endpoint paths are added to this base URL.

How do I authenticate with the BirkinBagStock API?

Its OpenAPI description does not declare an authentication scheme. Some endpoints may be open; check the provider's documentation before relying on that.

How many endpoints does the BirkinBagStock API have?

30 operations on 30 paths (28 GET, 2 POST).

Is forking the BirkinBagStock API free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.