Vintagebulk API
Vintagebulk API gives AI agents and developers programmatic access to the Vintagebulk wholesale catalog (graded second-hand branded clothing in boxes and bales for resellers). No sign-up or API key is needed for catalog and cart access.
Vintagebulk API overview
- OpenAPI 3.1 spec: /openapi.json (YAML: /openapi.yaml)
-
Storefront GraphQL API (versioned):
POST https://vintagebulk.nl/api/2026-10/graphql.json- tokenless, JSON in and out. -
Catalog REST (JSON):
GET /products.json,GET /products/{handle}.json,GET /collections/{handle}/products.json,GET /search/suggest.json?q=... -
Cart REST (JSON):
GET /cart.js,POST /cart/add.js,POST /cart/change.js -
Vintagebulk MCP server (UCP):
POST https://vintagebulk.nl/api/ucp/mcp- see Vintagebulk MCP server - Agent instructions: /agents.md (mirror: /llms.txt), sitemap: /sitemap.xml
Quick start
curl -sS https://vintagebulk.nl/api/2026-10/graphql.json \
-H 'Content-Type: application/json' \
-d '{"query":"{ products(first: 3) { nodes { title handle } } }"}'
API versioning and deprecation policy
- The Storefront GraphQL API is versioned in the URL path:
/api/YYYY-MM/graphql.json. Current stable version:2026-10. A new version is released every quarter and each version is supported for at least 12 months. - Every response returns the version that served it in the
X-Shopify-API-Versionheader. If you request a retired version, the oldest supported version answers and the header shows it: treat that as your deprecation signal and upgrade. - UCP is versioned by date; supported versions are listed at /.well-known/ucp.
- Breaking changes to the documented REST endpoints are announced at least 90 days in advance on this page and in the OpenAPI spec (
info.versionandx-deprecation-policy).
Errors
- REST/AJAX endpoints return JSON:
{"status": 422, "message": "Cart Error", "description": "Cannot find variant"}. - GraphQL returns
{"errors": [{"message": "...", "extensions": {"code": "undefinedField"}}]}; a non-JSON body returns HTTP 415 with codeUNSUPPORTED_MEDIA_TYPE. - The MCP endpoint returns JSON-RPC error objects, e.g.
{"error": {"code": -32600, "message": "Invalid Request"}}.
Rate limits
Requests are rate-limited per client IP. When you exceed the limit you get HTTP 429: back off exponentially (start at 1 s, max 60 s) and honour Retry-After when present.
Sandbox and testing
All read endpoints are free to call without credentials. There is no test mode on the live shop: build and test checkout flows against mock.shop (a free mock Shopify Storefront API with the same GraphQL schema), then point your client at vintagebulk.nl. Payment always requires explicit buyer approval.
Authentication (buyer-linked actions)
Buyer-linked checkout and order access uses Shopify Customer Account OAuth 2.0 (authorization code + PKCE). Scopes are listed in the OpenAPI spec; metadata at /.well-known/oauth-authorization-server.
Questions or bulk/wholesale integrations: info@vintagebulk.nl. More: developer overview.