API-dokumentation

Read-only JSON-API över Systembolagets sortiment. Alla svar är application/json. Ingen autentisering krävs.

GET /api/facets

Listor att bygga filter-dropdowns av: länder, kategorier (nivå 2), druvor och smaksymboler.

curl https://systembolaget.wwn.workers.dev/api/facets

{ "countries": [...], "categories": [...], "grapes": [...], "tasteSymbols": [...] }

GET /api/products

Sök/filtrera produkter. Returnerar en förkortad post per produkt (inte hela råa objektet).

Parameter	Beskrivning
`q`	Fritext, matchar namn eller producent
`country`	Exakt land, t.ex. `Frankrike`
`category`	Exakt kategori (nivå 2), t.ex. `Whisky`
`grape`	Exakt druva, t.ex. `Sauvignon blanc`
`symbol`	Exakt smaksymbol, t.ex. `Fisk`
`minPrice` / `maxPrice`	Prisintervall i kr
`sort`	`name` (default), `price_asc`, `price_desc`, `alcohol_asc`, `alcohol_desc`
`limit`	Max 100, default 30
`offset`	För paginering, default 0

curl "https://systembolaget.wwn.workers.dev/api/products?category=Whisky&sort=price_asc&limit=5"

{ "items": [{ "product_id": "...", "name_bold": "...", "price": 349, ... }], "hasMore": true }

GET /api/products/:id

Fullständig produktinformation (Systembolagets originalfält), för produktvyn.

curl https://systembolaget.wwn.workers.dev/api/products/631120

GET /api/products/:id/similar

Liknande produkter i samma kategori, rankat efter smakprofil (smakcirklarna), delade druvor/smaksymboler, ordöverlapp i smakbeskrivningen, samt närhet i land/ursprung/alkoholhalt.

Parameter	Beskrivning
`country`	Begränsa till ett land
`minPrice` / `maxPrice`	Prisintervall i kr
`sort`	`relevance` (default), `price_asc`, `price_desc`, `name`
`limit`	Max 50, default 12

curl "https://systembolaget.wwn.workers.dev/api/products/631120/similar?sort=price_asc"

Källa

Data hämtas från susbolaget.emrik.org och uppdateras dagligen via en GitHub Actions-pipeline.